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

Verwenden Sie nach Möglichkeit immer die neueste Version des Apache TinkerPop Python Gremlin-Clients, gremlinpython, die Ihre Engine-Version unterstützt. Neuere Versionen enthalten zahlreiche Fehlerbehebungen, die Stabilität, Leistung und Benutzerfreundlichkeit des Clients verbessern. Die zu gremlinpython verwendende Version entspricht in der Regel den TinkerPop Versionen, die in der Tabelle für den Java-Gremlin-Client beschrieben sind.

Anmerkung

Die gremlinpython 3.5.x-Versionen sind mit den TinkerPop 3.4.x-Versionen kompatibel, solange Sie in den Gremlin-Abfragen, die Sie schreiben, nur 3.4.x-Funktionen verwenden.

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 diesen Anweisungen von einer EC2 Amazon-Instance aus folgen, 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.

   Im folgenden Beispiel können Sie die Verwendung in einer IAM-fähigen Datenbank aktivieren, indem Sie eine Umgebungsvariable namens festlegen. USE_IAM Dabei werden die AWS standardisierte Anbieterkette für Anmeldeinformationen und das boto3 SDK verwendet, um Ihre Anfragen mit den entsprechenden SigV4-Anmeldeinformationen zu signieren.

   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"
   
   if "USE_IAM" in os.environ and bool(os.environ["USE_IAM"]):
   creds = boto3.Session().get_credentials().get_frozen_credentials()
   request = AWSRequest(method="GET", url=database_url, data=None)
   SigV4Auth(creds, "neptune-db", boto3.Session().region_name).add_auth(request)
   
   remoteConn = DriverRemoteConnection(database_url, "g", headers=request.headers.items())
   else:
   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.