Herstellen einer Verbindung mit einer Neptune-DB-Instance über Node.js

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

Der folgende Abschnitt führt Sie durch die Ausführung eines Node.js-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:

• Stellen Sie sicher, dass Node.js Version 8.11 oder höher installiert ist. Wenn nicht, laden Sie Node.js von der Nodejs.org-Website herunter und installieren Sie es.

Herstellen einer Verbindung mit Neptune über Node.js

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

   npm install gremlin

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

3. Kopieren Sie Folgendes in die gremlinexample.js-Datei. your-neptune-endpointErsetzen Sie durch die Adresse Ihrer Neptune-DB-Instance.

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

   const gremlin = require('gremlin');
   const DriverRemoteConnection = gremlin.driver.DriverRemoteConnection;
   const Graph = gremlin.structure.Graph;
   
   dc = new DriverRemoteConnection('wss://your-neptune-endpoint:8182/gremlin',{});
   
   const graph = new Graph();
   const g = graph.traversal().withRemote(dc);
   
   g.V().limit(1).count().next().
       then(data => {
           console.log(data);
           dc.close();
       }).catch(error => {
           console.log('ERROR', error);
           dc.close();
       });

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

   node gremlinexample.js

Das vorherige Beispiel gibt über die g.V().limit(1).count().next()-Traversierung die Anzahl eines einzelnen Vertex im Diagramm zurück. Um etwas anderes abzufragen, ersetzen Sie diese durch eine andere Gremlin-Traversierung mit einer der entsprechenden Ending-Methoden.

Anmerkung

Der letzte Teil der Gremlin-Abfrage, next(), 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()

Verwenden Sie next(), wenn die Abfrageergebnisse serialisiert und zurückgegeben werden sollen, andernfalls iterate().

Wichtig

Hierbei handelt es sich um ein eigenständiges Node.js-Beispiel. Wenn Sie planen, Code wie diesen in einer AWS Lambda Funktion auszuführen, finden Sie weitere Informationen Beispiele für Lambda-Funktionen zur JavaScript effizienten Verwendung in einer Neptune-Lambda-Funktion.