Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Servlet status Neptunus OpenCypher dan titik akhir status
Titik akhir status OpenCypher menyediakan akses ke informasi tentang kueri yang saat ini berjalan di server atau menunggu untuk dijalankan. Ini juga memungkinkan Anda membatalkan kueri tersebut. Titik akhir adalah:
https://(the server):(the port number)/openCypher/status
Anda dapat menggunakan HTTP GET dan POST metode untuk mendapatkan status saat ini dari server, atau untuk membatalkan kueri. Anda juga dapat menggunakan DELETE metode ini untuk membatalkan kueri yang sedang berjalan atau menunggu.
Parameter untuk permintaan status
Parameter kueri status
-
includeWaiting(trueataufalse) — Ketika disetel ketruedan parameter lain tidak ada, menyebabkan informasi status untuk permintaan menunggu dikembalikan serta untuk menjalankan kueri. -
cancelQuery— Digunakan hanya denganGETdanPOSTmetode, untuk menunjukkan bahwa ini adalah permintaan pembatalan.DELETEMetode ini tidak memerlukan parameter ini.Nilai
cancelQueryparameter tidak digunakan, tetapi ketikacancelQueryada,queryIdparameter diperlukan, untuk mengidentifikasi kueri mana yang akan dibatalkan. -
queryId— Berisi ID dari kueri tertentu.Ketika digunakan dengan
POSTmetodeGETor dancancelQueryparameter tidak ada,queryIdmenyebabkan informasi status dikembalikan untuk kueri spesifik yang diidentifikasi. JikacancelQueryparameter ada, maka kueri spesifik yangqueryIdmengidentifikasi dibatalkan.Saat digunakan dengan
DELETEmetode ini,queryIdselalu menunjukkan kueri tertentu yang akan dibatalkan. -
silent— Hanya digunakan saat membatalkan kueri. Jika diatur ketrue, menyebabkan pembatalan terjadi secara diam-diam.
Bidang respons permintaan status
Bidang respons status jika ID kueri tertentu tidak disediakan
acceptedQueryCount— Jumlah kueri yang telah diterima tetapi belum selesai, termasuk kueri dalam antrian.
runningQueryCount— Jumlah kueri OpenCypher yang sedang berjalan.
query — Daftar query OpenCypher saat ini.
Bidang respons status untuk kueri tertentu
queryId — id GUID untuk kueri. Neptune secara otomatis memberikan nilai ID ini ke setiap kueri, atau Anda juga dapat menetapkan ID Anda sendiri (lihat Menyuntikkan ID Kustom Ke Dalam Gremlin Neptune atau Kueri SPARQL).
queryString — Query yang dikirimkan. Ini dipotong menjadi 1024 karakter jika lebih panjang dari itu.
-
queryEvalStats— Statistik untuk kueri ini:
menunggu - Menunjukkan berapa lama kueri menunggu, dalam milidetik.
elapsed — Jumlah milidetik kueri telah berjalan sejauh ini.
dibatalkan —
Truemenunjukkan bahwa kueri dibatalkan, atauFalsebelum dibatalkan.
Contoh permintaan dan tanggapan status
-
Permintaan status semua pertanyaan, termasuk yang menunggu:
curl https://server:port/openCypher/status \ --data-urlencode "includeWaiting=true"Tanggapan:
{ "acceptedQueryCount" : 0, "runningQueryCount" : 0, "queries" : [ ] } -
Permintaan status kueri yang sedang berjalan, tidak termasuk yang menunggu::
curl https://server:port/openCypher/statusTanggapan:
{ "acceptedQueryCount" : 0, "runningQueryCount" : 0, "queries" : [ ] } -
Permintaan status kueri tunggal:
curl https://server:port/openCypher/status \ --data-urlencode "queryId=eadc6eea-698b-4a2f-8554-5270ab17ebee"Tanggapan:
{ "queryId" : "eadc6eea-698b-4a2f-8554-5270ab17ebee", "queryString" : "MATCH (n1)-[:knows]->(n2), (n2)-[:knows]->(n3), (n3)-[:knows]->(n4), (n4)-[:knows]->(n5), (n5)-[:knows]->(n6), (n6)-[:knows]->(n7), (n7)-[:knows]->(n8), (n8)-[:knows]->(n9), (n9)-[:knows]->(n10) RETURN COUNT(n1);", "queryEvalStats" : { "waited" : 0, "elapsed" : 23463, "cancelled" : false } } -
Permintaan untuk membatalkan kueri
1. Menggunakan
POST:curl -X POST https://server:port/openCypher/status \ --data-urlencode "cancelQuery" \ --data-urlencode "queryId=f43ce17b-db01-4d37-a074-c76d1c26d7a9"Tanggapan:
{ "status" : "200 OK", "payload" : true }2. Menggunakan
GET:curl -X GET https://server:port/openCypher/status \ --data-urlencode "cancelQuery" \ --data-urlencode "queryId=588af350-cfde-4222-bee6-b9cedc87180d"Tanggapan:
{ "status" : "200 OK", "payload" : true }3. Menggunakan
DELETE:curl -X DELETE \ -s "https://server:port/openCypher/status?queryId=b9a516d1-d25c-4301-bb80-10b2743ecf0e"Tanggapan:
{ "status" : "200 OK", "payload" : true }