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.
Verwenden von Gremlin für den Zugriff auf Grafikdaten in Amazon Neptune
Sie können die Gremlin Console verwenden, um damit zu experimentieren TinkerPop Grafiken und Abfragen in einer REPL-Umgebung (Read-Eval-Print Loop).
Das folgende Tutorial führt Sie durch die Verwendung der Gremlin-Konsole zum Hinzufügen von Eckpunkten, Kanten, Eigenschaften und mehr zu einem Neptun-Graphen und hebt einige Unterschiede in der Neptune-specific Gremlin-Implementierung.
In diesem Beispiel wird davon ausgegangen, dass Sie Folgendes durchgeführt haben:
Sie haben über SSH eine Verbindung mit einer Amazon–EC2-Instance hergestellt.
Sie haben einen Neptune-Cluster wie in Neptune-Cluster erstellen beschrieben erstellt.
Sie haben die Gremlin-Konsole wie in Installieren der Gremlin-Konsole beschrieben installiert.
Verwenden der Gremlin-Konsole
-
Wechseln Sie in den Ordner, in dem die Dateien der Gremlin-Konsole extrahiert werden.
cd apache-tinkerpop-gremlin-console-3.8.0 -
Geben Sie den folgenden Befehl ein, um die Gremlin-Konsole auszuführen.
bin/gremlin.shDie 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. -
Geben Sie an der
gremlin>-Eingabeaufforderung Folgendes ein, um eine Verbindung zur Neptune-DB-Instance herzustellen.:remote connect tinkerpop.server conf/neptune-remote.yaml -
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 -
Fügen Sie einen Eckpunkt mit Bezeichnung und Eigenschaft hinzu.
g.addV('person').property('name', 'justin')Dem Vertex wird eine
string-ID mit einer GUID zugewiesen. Alle Eckpunkt-IDs sind Zeichenfolgen in Neptune. -
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 Zahl1.Normale Eigenschaftsnamen müssen in Anführungszeichen eingeschlossen werden.
-
Ä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 dername-Eigenschaft entfernt.Wenn Sie
singlenicht angegeben haben, wird stattdessen der Wert dername-Eigenschaft angehängt, sofern dieser Vorgang noch nicht ausgeführt wurde. -
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
agemit dem Wert29hinzu, ersetzt jedoch keine vorhandenen Werte.Wenn die
age-Eigenschaft bereits einen Wert enthält, fügt dieser Befehl der Eigenschaft29an. Beispiel: Wenn dieage-Eigenschaft27lautet, ist der neue Wert[ 27, 29 ]. -
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.AnmerkungDie 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.iterateimmer 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.
-
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.
-
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) -
Löschen Sie einen Eckpunkt.
g.V().has('name', 'justin').drop()Entfernt den Vertex mit der
name-Eigenschaft gleichjustin.WichtigHör hier auf und du hast den vollen TinkerPop ApacheModernes Diagramm. Die Beispiele in der Abschnitt „Durchquerung“
des TinkerPop Für die Dokumentation verwenden Sie das moderne Diagramm. -
Führen Sie einen Durchlauf aus.
g.V().hasLabel('person')Gibt alle
person-Eckpunkte zurück. -
Führen Sie einen Durchlauf mit den 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". -
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")undhasLabel("Label3").Das
::-Trennzeichen ist dieser Verwendung vorbehalten.Sie können im
hasLabel-Schritt nicht mehrere Bezeichnungen angeben. Beispiel: FürhasLabel("Label1::Label2")gibt es keine Übereinstimmung. -
Spezifizieren Time/date.
g.V().property(single, 'lastUpdate', datetime('2018-01-01T00:00:00'))Für Gremlin-Abfragen, die als Textzeichenfolgen gesendet werden (Gremlin Console, HTTP REST oder über einen Treiber übermittelte Abfragezeichenfolgen), verwenden Sie den
datetime()Funktion — Neptune akzeptiert keine Rohdatenjava.util.DateWerte in Zeichenfolgenabfragen.datetime()akzeptiert eine ISO-8601-compliantdatetimeZeichenfolge.Unterstützt werden die folgenden Formate:
YYYY-MM-DD, YYYY-MM-DDTHH:mm,YYYY-MM-DDTHH:mm:SSundYYYY-MM-DDTHH:mm:SSZ.Neptune 1.5.0.0: GLV-Datetime-WerteBeginnend mit TinkerPop 3.8.0, das Java GLV gibt Datetime-Werte zurück als
java.time.OffsetDateTimestattjava.util.Date. Andere GLVs verwenden weiterhin ihren spracheigenen Datetime-Typ. Dasdatetime()Die oben gezeigte Funktion ist für Abfragen im Zeichenkettenmodus vorgesehen und ist nicht betroffen.Wenn Sie einen GLV verwenden, verwenden Sie den spracheigenen Datetime-Typ statt
java.util.Date. Beispiel:Java:
java.time.OffsetDateTimePython:
datetime.datetimeJavaScript:
Date.NET:
System.DateTimeGehe:
time.Time
Weitere Informationen finden Sie unter Verwendung der nativen Datum- und Uhrzeitangaben für GLV-Zeitdaten.
-
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.
AnmerkungDer
.next()-Schritt funktioniert nicht mit.drop(). Verwenden Sie stattdessen.iterate(). -
Wenn Sie fertig sind, geben Sie den folgenden Befehl ein, um die Gremlin-Konsole zu beenden.
:exit
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.