Herstellen einer Verbindung mit einer Neptune-DB-Instance über Python - Amazon Neptune

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.

Herstellen einer Verbindung mit einer Neptune-DB-Instance über Python

Wichtig

Die Auswahl der richtigen Apache TinkerPop Gremlin-Treiberversion ist entscheidend für die Kompatibilität mit Ihrer Neptune-Engine-Version. Die Verwendung einer inkompatiblen Version kann zu Verbindungsfehlern oder unerwartetem Verhalten führen. Ausführliche Informationen zur Versionskompatibilität finden Sie unterZugriff auf ein Neptune-Diagramm mit Gremlin.

Der folgende Abschnitt führt Sie durch die Ausführung eines Python-Beispiels mit Herstellung einer Verbindung zu einer Amazon-Neptune-DB-Instance und Ausführung einer Gremlin-Traversierung.

Sie müssen diese Anweisungen für eine Amazon-EC2-Instance befolgen, die sich in derselben Virtual Private Cloud (VPC) wie Ihre Neptune-DB-Instance befindet.

Bevor Sie beginnen, führen Sie die folgenden Schritte aus:

  • Laden Sie Python 3.6 oder höher von der Website Python.org herunter.

  • Überprüfen Sie, ob Sie pip installiert haben. Haben Sie pip nicht installiert oder sind sich nicht sicher, lesen Sie Do I need to install pip? in der pip-Dokumenation.

  • Wenn Ihre Python-Installation nicht bereits darüber verfügt, ist der Download von futures wie folgt möglich: pip install futures

Herstellen einer Verbindung mit Neptune über Python

  1. Geben Sie Folgendes ein, um das gremlinpython-Paket zu installieren:

    pip install --user gremlinpython

  2. Erstellen Sie eine Datei namens gremlinexample.py und öffnen Sie diese dann in einem Text-Editor.

  3. Kopieren Sie Folgendes in die gremlinexample.py-Datei. your-neptune-endpointErsetzen Sie durch die Adresse Ihres Neptune-DB-Clusters und your-neptune-port durch den Port Ihres Neptune-DB-Clusters (Standard:8182).

    Informationen zum Ermitteln der Adresse Ihrer Neptune-DB-Instance finden Sie im Abschnitt Verbinden mit Amazo-Neptune-Endpunkten.

    Das folgende Beispiel zeigt, wie man sich mit Gremlin Python verbindet. Informationen zur IAM-Konnektivität finden Sie unter. Herstellen einer Verbindung zu Amazon Neptune Neptune-Datenbanken mithilfe der IAM-Authentifizierung mit Gremlin Python 

    import boto3
import os
from botocore.auth import SigV4Auth
from botocore.awsrequest import AWSRequest
from gremlin_python.driver.driver_remote_connection import DriverRemoteConnection
from gremlin_python.process.anonymous_traversal import traversal

database_url = "wss://your-neptune-endpoint:your-neptune-port/gremlin"

remoteConn = DriverRemoteConnection(database_url, "g")

g = traversal().withRemote(remoteConn)

print(g.inject(1).toList())
remoteConn.close()

  4. Geben Sie den folgenden Befehl ein, um das Beispiel auszuführen:

    python gremlinexample.py

    Die Gremlin-Abfrage am Ende dieses Beispiel gibt die Knoten (g.V().limit(2)) in einer Liste zurück. Diese Liste wird dann mit der Python-Standardfunktion print gedruckt.

    Anmerkung

    Der letzte Teil der Gremlin-Abfrage, toList(), ist für die Übermittlung der Traversierung zur Auswertung an den Server erforderlich. Wenn Sie diese oder eine gleichwertige Methode nicht einschließen, wird die Abfrage nicht an die Neptune-DB-Instance übermittelt.

    Die folgenden Methoden senden die Abfrage an die Neptune-DB-Instance:

    • toList()

    • toSet()

    • next()

    • nextTraverser()

    • iterate()

    Das vorherige Beispiel gibt die ersten beiden Knoten im Diagramm über die g.V().limit(2).toList()-Traversierung zurück. Um etwas anderes abzufragen, ersetzen Sie diese durch eine andere Gremlin-Traversierung mit einer der entsprechenden Ending-Methoden.