Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
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 permintaan yang sedang berjalan atau menunggu.
Parameter untuk permintaan status
Parameter kueri status
-
includeWaiting
(true
ataufalse
) — Ketika disetel ketrue
dan parameter lain tidak ada, menyebabkan informasi status untuk permintaan menunggu dikembalikan serta untuk menjalankan kueri. -
cancelQuery
— Digunakan hanya denganGET
danPOST
metode, untuk menunjukkan bahwa ini adalah permintaan pembatalan.DELETE
Metode ini tidak memerlukan parameter ini.Nilai
cancelQuery
parameter tidak digunakan, tetapi ketikacancelQuery
ada,queryId
parameter diperlukan, untuk mengidentifikasi kueri mana yang akan dibatalkan. -
queryId
— Berisi ID dari kueri tertentu.Ketika digunakan dengan
POST
metodeGET
or dancancelQuery
parameter tidak ada,queryId
menyebabkan informasi status dikembalikan untuk kueri tertentu yang diidentifikasi. JikacancelQuery
parameter ada, maka kueri spesifik yangqueryId
mengidentifikasi dibatalkan.Saat digunakan dengan
DELETE
metode ini,queryId
selalu 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 —
True
menunjukkan bahwa kueri dibatalkan, atauFalse
belum 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 }