Servlet d'état et point de terminaison d'état Neptune OpenCypher - Amazon Neptune

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Servlet d'état et point de terminaison d'état Neptune OpenCypher

Le point de terminaison d'état d'OpenCypher permet d'accéder aux informations relatives aux requêtes en cours d'exécution sur le serveur ou en attente d'exécution. Il vous permet également d'annuler ces requêtes. Le point de terminaison est :

https://(the server):(the port number)/openCypher/status

Vous pouvez utiliser le HTTPGETetPOSTméthodes pour obtenir l'état actuel du serveur ou pour annuler une requête. Vous pouvez également utiliser le pluginDELETEméthode pour annuler une requête en cours d'exécution ou en attente.

Paramètres pour les demandes de statut

Paramètres des requêtes de statut

  • includeWaiting(trueoufalse) — Lorsque ce paramètre est réglé surtrueet les autres paramètres ne sont pas présents, entraîne le renvoi des informations d'état pour les requêtes en attente ainsi que pour les requêtes en cours d'exécution.

  • cancelQuery— Utilisé uniquement avecGETetPOSTméthodes, pour indiquer qu'il s'agit d'une demande d'annulation. Dans laDELETEla méthode n'a pas besoin de ce paramètre.

    La valeur decancelQueryle paramètre n'est pas utilisé, mais quandcancelQueryest présent, lequeryIdUn paramètre est requis pour identifier la requête à annuler.

  • queryId— Contient l'identifiant d'une requête spécifique.

    Lorsqu'il est utilisé avecGETouPOSTMéthode etcancelQueryle paramètre n'est pas présent,queryIdprovoque le renvoi d'informations d'état pour la requête spécifique qu'il identifie. Si l'icônecancelQueryle paramètre est présent, puis la requête spécifique quiqueryIdidentifie est annulé.

    Lorsqu'il est utilisé avecDELETEMéthode,queryIdindique toujours une requête spécifique à annuler.

  • silent— Utilisé uniquement lors de l'annulation d'une requête. Si défini surtrue, provoque l'annulation silencieuse.

Exemples de demandes de statut et de réponses

  • Demande concernant l'état de toutes les requêtes, y compris celles en attente :

    curl https://server:port/openCypher/status \ --data-urlencode "includeWaiting=true"

    Réponse :

    { "acceptedQueryCount" : 0, "runningQueryCount" : 0, "queries" : [ ] }
  • Demande d'état des requêtes en cours d'exécution,pasy compris ceux qui attendent : :

    curl https://server:port/openCypher/status

    Réponse :

    { "acceptedQueryCount" : 0, "runningQueryCount" : 0, "queries" : [ ] }
  • Demande de statut d'une seule requête :

    curl https://server:port/openCypher/status \ --data-urlencode "queryId=eadc6eea-698b-4a2f-8554-5270ab17ebee"

    Réponse :

    { "queryId" : "eadc6eea-698b-4a2f-8554-5270ab17ebee", "queryString" : "MATCH (n1)-[:knows]->(n2), (n2)-[:knows]->(n3), (n3)-[:knows]->(n4), (n4)-[:knows]->(n5), (n5)-[:knows]->(n6), (n6)-[:knows]->(n7), (n7)-[:knows]->(n8), (n8)-[:knows]->(n9), (n9)-[:knows]->(n10) RETURN COUNT(n1);", "queryEvalStats" : { "waited" : 0, "elapsed" : 23463, "cancelled" : false } }
  • Demandes d'annulation d'une requête

    1. A l'aide dePOST :

    curl -X POST https://server:port/openCypher/status \ --data-urlencode "cancelQuery" \ --data-urlencode "queryId=f43ce17b-db01-4d37-a074-c76d1c26d7a9"

    Réponse :

    { "status" : "200 OK", "payload" : true }

    2. A l'aide deGET :

    curl -X GET https://server:port/openCypher/status \ --data-urlencode "cancelQuery" \ --data-urlencode "queryId=588af350-cfde-4222-bee6-b9cedc87180d"

    Réponse :

    { "status" : "200 OK", "payload" : true }

    3. A l'aide deDELETE :

    curl -X DELETE \ -s "https://server:port/openCypher/status?queryId=b9a516d1-d25c-4301-bb80-10b2743ecf0e"

    Réponse :

    { "status" : "200 OK", "payload" : true }