View a markdown version of this page

Gremlin-Abfragestatus-API - Amazon Neptune
Abfragen auflistenStatus einer einzelnen Abfrage

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Gremlin-Abfragestatus-API

Sie können alle aktiven Gremlin-Abfragen auflisten oder den Status einer bestimmten Abfrage abrufen. Der zugrunde liegende HTTP-Endpunkt für beide Operationen ist. https://your-neptune-endpoint:port/gremlin/status

Liste der aktiven Gremlin-Abfragen

Um alle aktiven Gremlin-Abfragen aufzulisten, rufen Sie den Endpunkt ohne queryId Parameter auf.

Anforderungsparameter

  • includeWaiting (optional) — Wenn auf gesetztTRUE, umfasst die Antwort neben laufenden Abfragen auch wartende Abfragen.

Antwortsyntax

{
  "acceptedQueryCount": integer,
  "runningQueryCount": integer,
  "queries": [
    {
      "queryId": "guid",
      "queryEvalStats": {
        "waited": integer,
        "elapsed": integer,
        "cancelled": boolean
      },
      "queryString": "string"
    }
  ]
}

  • akzeptiert QueryCount — Die Anzahl der Abfragen, die akzeptiert, aber noch nicht abgeschlossen wurden, einschließlich Abfragen in der Warteschlange.

  • laufend QueryCount — Die Anzahl der aktuell laufenden Gremlin-Abfragen.

  • queries   –   Eine Liste der aktuellen Gremlin-Abfragen.

Beispiel

AWS CLI
aws neptunedata list-gremlin-queries \
  --endpoint-url https://your-neptune-endpoint:port

Weitere Informationen finden Sie unter list-gremlin-queries in der Befehlsreferenz. AWS CLI

SDK
import boto3
from botocore.config import Config

client = boto3.client(
    'neptunedata',
    endpoint_url='https://your-neptune-endpoint:port',
    config=Config(read_timeout=None, retries={'total_max_attempts': 1})
)

response = client.list_gremlin_queries()

print(response)

AWS SDK-Beispiele in anderen Sprachen wie Java, .NET und mehr finden Sie unter. AWS SDK

awscurl
awscurl https://your-neptune-endpoint:port/gremlin/status \
  --region us-east-1 \
  --service neptune-db
Anmerkung

In diesem Beispiel wird davon ausgegangen, dass Ihre AWS Anmeldeinformationen in Ihrer Umgebung konfiguriert sind. Ersetze es us-east-1 durch die Region deines Neptun-Clusters.

Weitere Informationen zur Verwendung awscurl mit der IAM-Authentifizierung finden Sie unter. Verwenden von awscurl mit temporären Anmeldeinformationen, um eine sichere Verbindung zu einem DB-Cluster mit aktivierter IAM-Authentifizierung herzustellen

curl
curl https://your-neptune-endpoint:port/gremlin/status

Die folgende Ausgabe zeigt eine einzelne laufende Abfrage.

{
  "acceptedQueryCount": 9,
  "runningQueryCount": 1,
  "queries": [
    {
      "queryId": "fb34cd3e-f37c-4d12-9cf2-03bb741bf54f",
      "queryEvalStats": {
        "waited": 0,
        "elapsed": 23,
        "cancelled": false
      },
      "queryString": "g.V().out().count()"
    }
  ]
}

Den Status einer bestimmten Gremlin-Abfrage abrufen

Um den Status einer bestimmten Gremlin-Abfrage abzurufen, geben Sie den Parameter anqueryId.

Anforderungsparameter

Antwortsyntax

{
  "queryId": "guid",
  "queryString": "string",
  "queryEvalStats": {
    "waited": integer,
    "elapsed": integer,
    "cancelled": boolean,
    "subqueries": document
  }
}

  • queryId — Die ID der Abfrage.

  • queryString   –   Die übermittelte Abfrage. Die Abfrage wird nach 1024 Zeichen abgeschnitten, wenn sie länger ist.

  • query EvalStats — Statistiken für die Abfrage, einschließlich waited (Wartezeit in Millisekunden), elapsed (Laufzeit in Millisekunden), (ob die Abfrage abgebrochen wurde) und cancelled (Anzahl der Unterabfragen). subqueries

Beispiel

AWS CLI
aws neptunedata get-gremlin-query-status \
  --endpoint-url https://your-neptune-endpoint:port \
  --query-id "fb34cd3e-f37c-4d12-9cf2-03bb741bf54f"

Weitere Informationen finden Sie unter get-gremlin-query-status in der Befehlsreferenz. AWS CLI

SDK
import boto3
from botocore.config import Config

client = boto3.client(
    'neptunedata',
    endpoint_url='https://your-neptune-endpoint:port',
    config=Config(read_timeout=None, retries={'total_max_attempts': 1})
)

response = client.get_gremlin_query_status(
    queryId='fb34cd3e-f37c-4d12-9cf2-03bb741bf54f'
)

print(response)

AWS SDK-Beispiele in anderen Sprachen wie Java, .NET und mehr finden Sie unter. AWS SDK

awscurl
awscurl https://your-neptune-endpoint:port/gremlin/status/fb34cd3e-f37c-4d12-9cf2-03bb741bf54f \
  --region us-east-1 \
  --service neptune-db
Anmerkung

In diesem Beispiel wird davon ausgegangen, dass Ihre AWS Anmeldeinformationen in Ihrer Umgebung konfiguriert sind. Ersetze es us-east-1 durch die Region deines Neptun-Clusters.

Weitere Informationen zur Verwendung awscurl mit der IAM-Authentifizierung finden Sie unter. Verwenden von awscurl mit temporären Anmeldeinformationen, um eine sichere Verbindung zu einem DB-Cluster mit aktivierter IAM-Authentifizierung herzustellen

curl
curl https://your-neptune-endpoint:port/gremlin/status/fb34cd3e-f37c-4d12-9cf2-03bb741bf54f

Nachfolgend finden Sie eine Beispielantwort.

{
  "queryId": "fb34cd3e-f37c-4d12-9cf2-03bb741bf54f",
  "queryString": "g.V().out().count()",
  "queryEvalStats": {
    "waited": 0,
    "elapsed": 23,
    "cancelled": false
  }
}