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.

Verwenden von Befehlszeilentools für den Zugriff auf Amazon Neptune

Sie können die AWS CLI AWS SDKs und HTTP-Tools wie curl und verwenden, awscurl um Anfragen an Ihren Neptune-DB-Cluster zu senden. In den folgenden Abschnitten wird gezeigt, wie Sie die einzelnen Tools einrichten und grundlegende Gremlin- und OpenCypher-Abfragen ausführen.

Verwendung der AWS CLI

Mit den aws neptunedata Befehlen können Sie Gremlin- und OpenCypher-Abfragen ausführen, den Engine-Status überprüfen, Massenladungen verwalten und vieles mehr. Die vollständige Befehlsreferenz finden neptunedataSie in der Befehlsreferenz. AWS CLI

Die folgenden Beispiele zeigen, wie eine einfache Abfrage ausgeführt wird:

Gremlin

aws neptunedata execute-gremlin-query \
  --endpoint-url https://your-neptune-endpoint:port \
  --region us-east-1 \
  --gremlin-query "g.V().limit(1)"

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

openCypher

aws neptunedata execute-open-cypher-query \
  --endpoint-url https://your-neptune-endpoint:port \
  --region us-east-1 \
  --open-cypher-query "MATCH (n) RETURN n LIMIT 1"

Weitere Informationen finden Sie unter execute-open-cypher-query in der Befehlsreferenz. AWS CLI

Verwendung der AWS SDK

Sie können die Neptune Data API über die AWS SDKs verwenden, um Abfragen programmgesteuert auszuführen. Die folgenden Python-Beispiele zeigen, wie eine einfache Abfrage ausgeführt wird:

Gremlin

import boto3
import json
from botocore.config import Config

# Disable the client-side read timeout and retries so that
# Neptune's server-side neptune_query_timeout controls query duration.
client = boto3.client(
    'neptunedata',
    endpoint_url='https://your-neptune-endpoint:port',
    config=Config(read_timeout=None, retries={'total_max_attempts': 1})
)

response = client.execute_gremlin_query(
    gremlinQuery='g.V().limit(1)',
    serializer='application/vnd.gremlin-v3.0+json;types=false'
)

print(json.dumps(response['result'], indent=2))

AWS SDK-Beispiele in anderen Sprachen finden Sie unterAWS SDK.

openCypher

import boto3
import json
from botocore.config import Config

# Disable the client-side read timeout and retries so that
# Neptune's server-side neptune_query_timeout controls query duration.
client = boto3.client(
    'neptunedata',
    endpoint_url='https://your-neptune-endpoint:port',
    config=Config(read_timeout=None, retries={'total_max_attempts': 1})
)

response = client.execute_open_cypher_query(
    openCypherQuery='MATCH (n) RETURN n LIMIT 1'
)

print(json.dumps(response['results'], indent=2))

AWS SDK-Beispiele in anderen Sprachen finden Sie unterAWS SDK.

Verwenden von curl und awscurl

Das curl-Befehlszeilentool sendet HTTP-Anfragen direkt an die Neptune-Endpunkte. Wenn die IAM-Authentifizierung aktiviert ist, verwenden Sie awscurl oder 7.75.0+ mit der Option, Anfragen zu signieren. curl --aws-sigv4 Weitere Informationen finden Sie unter Verwenden von awscurl mit temporären Anmeldeinformationen, um eine sichere Verbindung zu einem DB-Cluster mit aktivierter IAM-Authentifizierung herzustellen.

Curl für HTTPS einrichten

Um eine Verbindung über HTTPS herzustellen (wie es Neptune in den meisten Regionen erfordert), curl ist Zugriff auf entsprechende Zertifikate erforderlich. Informationen zum Abrufen von Zertifikaten und deren Formatierung in einen Zertifizierungsstellenspeicher (CA) finden Sie in der curl Dokumentation unter SSL-Zertifikatsverifizierung.

Sie können den Speicherort dieses CA-Zertifikatsspeichers mithilfe der CURL_CA_BUNDLE Umgebungsvariablen angeben. Unter Windows sucht curl automatisch in einer Datei mit dem Namen curl-ca-bundle.crt danach. Es sucht zunächst in demselben Verzeichnis wie curl.exe und anschließend an anderer Stelle im Pfad. Weitere Informationen finden Sie unter SSL Certificate Verification.

Solange curl die entsprechenden Zertifikate finden kann, werden HTTPS-Verbindungen wie HTTP-Verbindungen behandelt, ohne dass zusätzliche Parameter angegeben werden müssen. Die Beispiele in dieser Dokumentation basieren auf diesem Szenario.

Weitere Informationen über das Tool finden Sie in der curl-Manpage und im Buch Everything curl.

Abfragebeispiele

Die folgenden Beispiele zeigen, wie eine einfache Abfrage mit curl und ausgeführt wird: awscurl

Gremlin (awscurl)

awscurl https://your-neptune-endpoint:port/gremlin \
  --region us-east-1 \
  --service neptune-db \
  -X POST \
  -d '{"gremlin":"g.V().limit(1)"}'

Gremlin (curl)

curl -X POST \
  -d '{"gremlin":"g.V().limit(1)"}' \
  https://your-neptune-endpoint:port/gremlin

Anmerkung

Plain curl funktioniert nur, wenn die IAM-Authentifizierung auf Ihrem Cluster nicht aktiviert ist.

openCypher (awscurl)

awscurl https://your-neptune-endpoint:port/openCypher \
  --region us-east-1 \
  --service neptune-db \
  -X POST \
  -d "query=MATCH (n) RETURN n LIMIT 1"

openCypher (curl)

curl -X POST \
  -d "query=MATCH (n) RETURN n LIMIT 1" \
  https://your-neptune-endpoint:port/openCypher

Anmerkung

Plain curl funktioniert nur, wenn die IAM-Authentifizierung auf Ihrem Cluster nicht aktiviert ist.

Weitere Gremlin-HTTP-Beispiele finden Sie unter. HTTPS REST Weitere OpenCypher-HTTP-Beispiele finden Sie unter. HTTPS-Endpunkt