Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Uji kode Gremlin dalam konteks Anda akan menyebarkannya

Gremlin menyediakan beberapa cara bagi klien untuk mengirimkan kueri ke server. Mode pengiriman ini berbeda dalam bagaimana kueri dievaluasi dan bagaimana transaksi berperilaku. Perbedaan ini dapat menyebabkan hasil yang tidak terduga jika Anda mengembangkan dalam satu mode dan menerapkan di mode lain.

Mode skrip (pengiriman berbasis string)

Dalam mode skrip, klien mengirimkan seluruh kueri sebagai string teks ke server. Server mengevaluasi string lengkap, termasuk langkah-langkah terminal apa pun, dan mengalirkan hasilnya kembali ke klien. Alat dan metode berikut menggunakan mode skrip:

Dalam mode skrip, klien mengirimkan kueri seperti berikut ke server sebagai string lengkap:

// 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()");

Server mengevaluasi kueri lengkap termasuk.next(). Jika tidak .next() menemukan hasil, server menaikkan NoSuchElementException dan transaksi berputar kembali.

Mode bytecode (objek traversal GLV)

Dalam mode bytecode, klien membangun objek traversal secara lokal menggunakan Gremlin Language Variant (GLV). Pengemudi membuat serial langkah traversal sebagai bytecode dan mengirimkannya ke server. Langkah-langkah terminal seperti .toList() atau .next() eksekusi di sisi klien untuk mengulangi hasil yang dikembalikan oleh server. Anda dapat menggunakan mode bytecode dengan Java, Python, Go, .NET JavaScript, dan TinkerPop-compliant driver pihak ketiga lainnya yang sesuai dengan versi mesin Neptunus yang digunakan.

Dalam mode bytecode, kueri yang sama terlihat seperti ini:

// 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();

Driver hanya mengirimkan traversal steps (g.V().addV().V()) sebagai bytecode. Server berhasil mengevaluasi traversal, melakukan transaksi, dan mengembalikan set hasil. Klien kemudian memanggil .next() secara lokal untuk membaca dari set hasil. Jika set hasil kosong, klien menaikkanNoSuchElementException, tetapi transaksi telah dilakukan di server.

Perbedaan perilaku transaksi

Perbedaan kritis antara mode ini adalah bagaimana langkah-langkah terminal memengaruhi transaksi:

Langkah-langkah terminal

Di Gremlin, langkah terminal adalah langkah-langkah yang menyebabkan traversal diserahkan ke Neptunus untuk dievaluasi. Dalam mode bytecode, langkah terminal memicu driver untuk membuat serial dan mengirim traversal. Dalam mode skrip, langkah terminal adalah bagian dari string kueri yang dievaluasi di server. Langkah-langkah terminal adalah:

Jika Anda mengembangkan dan menguji kode Anda dalam satu konteks, Anda dapat mengalami masalah. Misalnya, konsol Gremlin mengirimkan kueri sebagai skrip. Kode Anda mungkin berperilaku berbeda dalam produksi jika Anda menerapkannya dalam konteks yang berbeda, seperti melalui driver Java menggunakan bytecode.