Einrichten der Gremlin-Konsole zum Herstellen einer Verbindung mit einer Neptune-DB-Instance

Installieren der Gremlin-Konsole und Verbinden mit Neptune

1. Die Binärdateien der Gremlin-Konsole erfordern Java 8 oder Java 11. Diese Anweisungen setzen die Verwendung von Java 11 voraus. Sie können Java 11 wie folgt auf Ihrer EC2 Instance installieren:

   • Wenn Sie Amazon Linux 2 (AL2) verwenden:

     sudo amazon-linux-extras install java-openjdk11

   • Wenn Sie Amazon Linux 2023 (AL2023) verwenden:

     sudo yum install java-11-amazon-corretto-devel

   • Verwenden Sie für andere Distributionen die jeweils zutreffende Anweisung:

     sudo yum install java-11-openjdk-devel

     oder:

     sudo apt-get install openjdk-11-jdk

2. Geben Sie Folgendes ein, um Java 11 als Standard-Runtime für Ihre EC2 Instance festzulegen.

   sudo /usr/sbin/alternatives --config java

   Geben Sie die Nummer für Java 11 ein, wenn Sie aufgefordert werden.

3. Laden Sie die entsprechende Version der Gremlin-Konsole von der Apache-Website herunter. Sie können auf der Java-Gremlin-Client-Seite nach der Neptune-Engine-Version suchen, die Sie gerade ausführen, um festzustellen, welche Gremlin-Version sie unterstützt. Für Version 3.7.2 können Sie beispielsweise die Gremlin-Konsole von der Apache Tinkerpop3-Website wie folgt auf Ihre Instanz herunterladen: EC2

   wget https://archive.apache.org/dist/tinkerpop/3.7.2/apache-tinkerpop-gremlin-console-3.7.2-bin.zip

4. Entpacken Sie die ZIP-Datei der Gremlin-Konsole.

   unzip apache-tinkerpop-gremlin-console-3.7.2-bin.zip

5. Ändern Sie die Verzeichnisse im extrahierten Verzeichnis.

   cd apache-tinkerpop-gremlin-console-3.7.2

6. Erstellen Sie im Unterverzeichnis conf des extrahierten Verzeichnisses eine Datei namens neptune-remote.yaml mit dem folgenden Text. Ersetzen your-neptune-endpoint mit dem Hostnamen oder der IP-Adresse Ihrer Neptune-DB-Instance. Die eckigen Klammern ([ ]) sind erforderlich.

   Anmerkung

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

   hosts: [your-neptune-endpoint]
   port: 8182
   connectionPool: { enableSsl: true }
   serializer: { className: org.apache.tinkerpop.gremlin.util.ser.GraphBinaryMessageSerializerV1,
                 config: { serializeResultToString: true }}

   Anmerkung

   Serializer wurden in Version 3.7.0 vom gremlin-driver Modul auf das neue gremlin-util Modul verschoben. Das Paket wurde von org.apache.tinkerpop.gremlin.driver.ser zu org.apache.tinkerpop.gremlin.util.ser geändert.

7. Navigieren Sie in einem Terminalfenster zu dem Verzeichnis der Gremlin-Konsole (apache-tinkerpop-gremlin-console-3.7.2), und geben Sie den folgenden Befehl ein, um die Gremlin-Konsole auszuführen.

   bin/gremlin.sh

   Die Ausgabe sollte folgendermaßen aussehen:

            \,,,/
            (o o)
   -----oOOo-(3)-oOOo-----
   plugin activated: tinkerpop.server
   plugin activated: tinkerpop.utilities
   plugin activated: tinkerpop.tinkergraph
   gremlin> 

   Sie sehen nun die gremlin>-Eingabeaufforderung. Die nächsten Schritte geben Sie über diese Eingabeaufforderung ein.

8. Geben Sie an der gremlin>-Eingabeaufforderung Folgendes ein, um eine Verbindung zur Neptune-DB-Instance herzustellen.

   :remote connect tinkerpop.server conf/neptune-remote.yaml

9. Geben Sie an der gremlin>-Eingabeaufforderung Folgendes ein, um in den Remote-Modus zu wechseln. Dadurch werden alle Gremlin-Abfragen an die Remote-Verbindung gesendet.

   :remote console

10. Geben Sie Folgendes ein, um eine Abfrage an den Gremlin-Graph zu senden.

    g.V().limit(1)

11. Wenn Sie fertig sind, geben Sie den folgenden Befehl ein, um die Gremlin-Konsole zu beenden.

    :exit