View a markdown version of this page

Testen Sie den Gremlin-Code in dem Kontext, in dem Sie ihn einsetzen werden - Amazon Neptune

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.

Testen Sie den Gremlin-Code in dem Kontext, in dem Sie ihn einsetzen werden

Gremlin bietet Clients mehrere Möglichkeiten, Abfragen an den Server zu senden. Diese Übermittlungsmodi unterscheiden sich darin, wie Abfragen ausgewertet werden und wie sich Transaktionen verhalten. Diese Unterschiede können zu unerwarteten Ergebnissen führen, wenn Sie in einem Modus entwickeln und in einem anderen bereitstellen.

Skriptmodus (zeichenfolgenbasierte Einreichung)

Im Skriptmodus sendet der Client die gesamte Abfrage als Textzeichenfolge an den Server. Der Server wertet die komplette Zeichenfolge aus, einschließlich aller Schritte im Terminalund streamt die Ergebnisse zurück an den Client. Die folgenden Tools und Methoden verwenden den Skriptmodus:

Im Skriptmodus sendet der Client eine Abfrage wie die folgende als vollständige Zeichenfolge an den Server:

// Script mode – the entire string, including .next(), is sent to the server // V('non-existing-id') yields nothing because no vertex with that ID exists Cluster cluster = Cluster.build().addContactPoint("your-neptune-endpoint") .port(8182).enableSsl(true).create(); Client client = cluster.connect(); client.submit("g.V('existing-id').addV('person').V('non-existing-id').next()");

Der Server wertet die vollständige Abfrage aus, einschließlich .next(). Wenn .next() findet keine Ergebnisse, der Server gibt einen aus NoSuchElementException und die Transaktion rollt zurück.

Bytecode-Modus (GLV-Traversal-Objekte)

Im Bytecode-Modus erstellt der Client lokal ein Traversal-Objekt mithilfe einer Gremlin Language Variant (GLV). Der Treiber serialisiert die Traversierungsschritte als Bytecode und sendet sie an den Server. Terminalschritte wie .toList() oder .next() ausführen auf dem clientseitig um über die vom Server zurückgegebenen Ergebnisse zu iterieren. Sie können den Bytecode-Modus verwenden mit Java, Python, Geh, .NET, JavaScript, und andere Drittanbieter TinkerPop-compliant Treiber, die für die verwendete Neptune-Engine-Version geeignet sind.

Im Bytecode-Modus sieht dieselbe Abfrage wie folgt aus:

// Bytecode mode – the driver sends the traversal steps as bytecode // .next() executes on the client to iterate results Cluster cluster = Cluster.build().addContactPoint("your-neptune-endpoint") .port(8182).enableSsl(true).create(); GraphTraversalSource g = traversal().withRemote( DriverRemoteConnection.using(cluster)); g.V("existing-id").addV("person").V("non-existing-id").next();

Der Treiber sendet nur die Traversierungsschritte (g.V().addV().V()) als Bytecode. Der Server wertet den Durchlauf erfolgreich aus, schreibt die Transaktion fest und gibt die Ergebnismenge zurück. Der Client ruft dann an .next() lokal, um aus der Ergebnismenge zu lesen. Wenn die Ergebnismenge leer ist, gibt der Client eine NoSuchElementException, aber die Transaktion hat bereits zugesagt auf dem Server.

Unterschiede im Transaktionsverhalten

Der entscheidende Unterschied zwischen diesen Modi besteht darin, wie sich Terminalschritte auf Transaktionen auswirken:

  • Skriptmodus — Der Server wertet die Terminalschritte aus. Wenn ein Terminalschritt wie .next() schlägt fehl, weil die Ergebnismenge leer ist, behandelt der Server die Abfrage als fehlgeschlagen und rollt zurück die Transaktion. Der Server behält keine Mutationen in derselben Traversierung bei (wie z. B. addV()).

  • Bytecode-Modus — Der Client wertet die Terminalschritte aus. Der Server wertet nur die Durchlaufschritte aus, schreibt die Transaktion erfolgreich fest und gibt Ergebnisse zurück. Wenn der Client dann anruft .next() bei einer leeren Ergebnismenge das resultierende NoSuchElementException ist nur ein clientseitiger Fehler. Die Transaktion wurde bereits bestätigt, also der Server bleibt bestehen irgendwelche Mutationen.

Schritte im Terminal

In Gremlin letzte Stufen sind die Schritte, die dazu führen, dass Neptun eine Traversierung zur Auswertung übermittelt wird. Im Bytecode-Modus veranlasst der Terminalschritt den Treiber, den Traversal zu serialisieren und zu senden. Im Skriptmodus ist der Terminalschritt Teil der Abfragezeichenfolge, die auf dem Server ausgewertet wird. Die Terminalschritte sind:

  • hasNext() — Kehrt zurück true wenn Ergebnisse verfügbar sind, false andernfalls.

  • next() — Gibt das nächste Ergebnis zurück. Wirft NoSuchElementException wenn keine Ergebnisse vorliegen.

  • next(n) — Gibt das nächste zurück n Ergebnisse als Liste.

  • toList() — Gibt alle Ergebnisse als Liste zurück. Gibt eine leere Liste zurück, wenn keine Ergebnisse vorhanden sind.

  • toSet() — Gibt alle Ergebnisse als Satz zurück. Gibt ein leeres Set zurück, wenn keine Ergebnisse vorhanden sind.

  • iterate() — Wiederholt alle Ergebnisse, ohne sie zurückzugeben. Verwenden Sie dies für Mutationen, bei denen Sie den Rückgabewert nicht benötigen.

Anmerkung

GLVs in einzelnen Sprachen können zusätzliche Terminalschritte enthalten, die für ihre Implementierung spezifisch sind. Einzelheiten finden Sie auf den sprachspezifischen Seiten.

Wenn Sie Ihren Code in einem Kontext entwickeln und testen, können Probleme auftreten. Beispielsweise übermittelt die Gremlin-Konsole Abfragen als Skripte. Ihr Code könnte sich in der Produktion anders verhalten, wenn Sie ihn in einem anderen Kontext bereitstellen, z. B. über den Java-Treiber, der Bytecode verwendet.

Wichtig

Stellen Sie sicher, dass Sie Gremlin-Code im gleichen Übermittlungsmodus testen, in dem er bereitgestellt wird, um unerwartetes Transaktionsverhalten zu vermeiden.