Verwenden von Gremlin für den Zugriff auf Diagramme in Amazon Neptune

Sie können die Gremlin-Konsole verwenden, um mit TinkerPop Graphen und Abfragen in einer REPL (read-eval-print Loop-) Umgebung zu experimentieren.

Das folgende Tutorial führt Sie durch die Verwendung der Gremlin-Konsole und zeigt, wie Sie Eckpunkte, Kanten, Eigenschaften und mehr zu Graph-Diagrammen hinzufügen. Außerdem wird auch auf einige Besonderheiten bei der Neptune-spezifischen Gremlin-Implementierung hingewiesen.

Anmerkung

In diesem Beispiel wird davon ausgegangen, dass Sie Folgendes durchgeführt haben:

• Sie haben eine Verbindung mit SSH einer EC2 Amazon-Instance hergestellt.

• Sie haben einen Neptune-Cluster wie in DB-Cluster erstellen beschrieben erstellt.

• Sie haben die Gremlin-Konsole wie in Installieren der Gremlin-Konsole beschrieben installiert.

Verwenden der Gremlin-Konsole

1. Wechseln Sie in den Ordner, in dem die Dateien der Gremlin-Konsole extrahiert werden.

   cd apache-tinkerpop-gremlin-console-3.6.5

2. 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.

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

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

4. 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

5. Fügen Sie einen Eckpunkt mit Bezeichnung und Eigenschaft hinzu.

   g.addV('person').property('name', 'justin')

   Dem Scheitelpunkt wird eine string ID zugewiesen, die eine GUID enthält. Alle Scheitelpunkte IDs sind Zeichenketten in Neptune.

6. Fügen Sie einen Eckpunkt mit einer benutzerdefinierter ID hinzu.

   g.addV('person').property(id, '1').property('name', 'martin')

   Die id-Eigenschaft wird nicht in Anführungszeichen gesetzt. Es handelt sich um ein Schlüsselwort für die ID des Vertex. Die Vertex-ID ist eine Zeichenfolge mit der Zahl 1.

   Normale Eigenschaftsnamen müssen in Anführungszeichen eingeschlossen werden.

7. Ändern Sie die Eigenschaft oder fügen Sie eine Eigenschaft hinzu, wenn keine vorhanden ist.

   g.V('1').property(single, 'name', 'marko')

   Hier ändern Sie die name-Eigenschaft für den Vertex aus dem vorherigen Schritt. Dadurch werden alle vorhandenen Werte aus der name-Eigenschaft entfernt.

   Wenn Sie single nicht angegeben haben, wird stattdessen der Wert der name-Eigenschaft angehängt, sofern dieser Vorgang noch nicht ausgeführt wurde.

8. Hinzufügen einer Eigenschaft bzw. Anfügen der Eigenschaft, wenn die Eigenschaft bereits über einen Wert verfügt

   g.V('1').property('age', 29)

   Neptune verwendet Set-Kardinalität als Standardaktion.

   Dieser Befehl fügt die Eigenschaft age mit dem Wert 29 hinzu, ersetzt jedoch keine vorhandenen Werte.

   Wenn die age-Eigenschaft bereits einen Wert enthält, fügt dieser Befehl der Eigenschaft 29 an. Beispiel: Wenn die age-Eigenschaft 27 lautet, ist der neue Wert [ 27, 29 ].

9. Fügen Sie mehrere Eckpunkte hinzu.

   g.addV('person').property(id, '2').property('name', 'vadas').property('age', 27).iterate()
   g.addV('software').property(id, '3').property('name', 'lop').property('lang', 'java').iterate()
   g.addV('person').property(id, '4').property('name', 'josh').property('age', 32).iterate()
   g.addV('software').property(id, '5').property('name', 'ripple').property('lang', 'java').iterate()
   g.addV('person').property(id, '6').property('name', 'peter').property('age', 35)

   Sie können mehrere Anweisungen gleichzeitig an Neptune senden.

   Anweisungen können durch Zeilenumbrüche ('\n'), Leerzeichen (' '), Semikolon ('; ') oder nichts (g.addV(‘person’).iterate()g.V() ist z. B. gültig) getrennt werden.

   Anmerkung

   Die Gremlin-Konsole sendet bei jedem Zeilenumbruch ('\n') einen separaten Befehl, sodass in diesem Fall jeweils eine separate Transaktion stattfindet. Dieses Beispiel enthält alle Befehle in getrennten Zeilen, um die Lesbarkeit zu verbessern. Entfernen Sie die Zeilenumbruch-Zeichen ('\n'), um sie als einen einzelnen Befehl über die Gremlin-Konsole zu senden.

   Alle Anweisungen mit Ausnahme der letzten müssen mit einem Beendigungsschritt wie .next() oder .iterate() enden. Andernfalls werden sie nicht ausgeführt. Die Gremlin-Konsole erfordert keinen Beendigungsschritt. Verwenden Sie .iterate immer dann, wenn die Ergebnisse nicht serialisiert werden müssen.

   Alle Anweisungen, die zusammen gesendet werden, sind in einer einzigen Transaktion enthalten und sind entweder alle erfolgreich oder schlagen alle fehl.

10. Fügen Sie Eckpunkte hinzu.

    g.V('1').addE('knows').to(__.V('2')).property('weight', 0.5).iterate()
    g.addE('knows').from(__.V('1')).to(__.V('4')).property('weight', 1.0) 

    Nachfolgend sind zwei verschiedene Möglichkeiten zum Hinzufügen einer Edge aufgeführt.

11. Fügen Sie den Rest des Graphs „Modern“ hinzu.

    g.V('1').addE('created').to(__.V('3')).property('weight', 0.4).iterate()
    g.V('4').addE('created').to(__.V('5')).property('weight', 1.0).iterate()
    g.V('4').addE('knows').to(__.V('3')).property('weight', 0.4).iterate()
    g.V('6').addE('created').to(__.V('3')).property('weight', 0.2)
    

12. Löschen Sie einen Eckpunkt.

    g.V().has('name', 'justin').drop()

    Entfernt den Vertex mit der name-Eigenschaft gleich justin.

    Wichtig

    Wenn Sie hier aufhören, haben Sie das vollständige Apache TinkerPop Modern-Diagramm. Die Beispiele im Abschnitt Traversal der TinkerPop Dokumentation verwenden den Modern-Graphen.

13. Führen Sie einen Durchlauf aus.

    g.V().hasLabel('person')

    Gibt alle person-Eckpunkte zurück.

14. Führen Sie eine Durchquerung mit Werten (()) valueMap aus.

    g.V().has('name', 'marko').out('knows').valueMap()

    Gibt Schlüssel-Wert-Paare für alle Vertices zurück, die marko "kennt".

15. Geben Sie mehrere Bezeichnungen an.

    g.addV("Label1::Label2::Label3") 

    Neptune unterstützt mehrere Bezeichnungen für einen Eckpunkt. Sie können mehrere Bezeichnungen angeben, indem Sie diese durch :: trennen.

    In diesem Beispiel wird ein Vertex mit drei verschiedenen Bezeichnungen hinzugefügt.

    Der hasLabel-Schritt entspricht dem Knoten mit allen drei Bezeichnungen: hasLabel("Label1"), hasLabel("Label2") und hasLabel("Label3").

    Das ::-Trennzeichen ist dieser Verwendung vorbehalten.

    Sie können im hasLabel-Schritt nicht mehrere Bezeichnungen angeben. Beispiel: Für hasLabel("Label1::Label2") gibt es keine Übereinstimmung.

16. Geben Sie Uhrzeit/Datum an.

    g.V().property(single, 'lastUpdate', datetime('2018-01-01T00:00:00'))

    Neptune unterstützt kein Java-Datum. Verwenden Sie stattdessen die datetime() Funktion. datetime()akzeptiert eine ISO8 061-konforme Zeichenfolgedatetime.

    Unterstützt werden die folgenden Formate: YYYY-MM-DD, YYYY-MM-DDTHH:mm, YYYY-MM-DDTHH:mm:SS und YYYY-MM-DDTHH:mm:SSZ.

17. Löschen Sie Eckpunkte, Eigenschaften oder Edges.

    g.V().hasLabel('person').properties('age').drop().iterate()
    g.V('1').drop().iterate()
    g.V().outE().hasLabel('created').drop()

    Im Folgenden finden Sie einige "drop"-Beispiele.

    Anmerkung

    Der .next()-Schritt funktioniert nicht mit .drop(). Verwenden Sie stattdessen .iterate().

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

    :exit

Anmerkung

Verwenden Sie ein Semikolon (;) oder ein Zeilenumbruchzeichen (\n), um die Anweisungen voneinander abzutrennen.

Jede Traversierung, die der letzten Traversierung vorausgeht, muss zum Ausführen mit iterate() enden. Es werden nur die Daten der letzten Traversierung zurückgegeben.