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"
    }
  ]
}

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

  • runningQueryCount— 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 list-gremlin-queriesin der AWS CLI Befehlsreferenz.

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 unterAWS 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 für sichere Verbindungen zu DB-Clustern mit aktivierter IAM-Authentifizierung

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.

  • queryEvalStats— Statistiken für die Abfrage, einschließlich waited (Wartezeit in Millisekunden), elapsed (Laufzeit in Millisekunden), cancelled (ob die Abfrage abgebrochen wurde) und (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 in der Befehlsreferenz. get-gremlin-query-status 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 unterAWS 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 für sichere Verbindungen zu DB-Clustern mit aktivierter IAM-Authentifizierung

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
  }
}