View a markdown version of this page

Servlet status Neptunus OpenCypher dan titik akhir status - Amazon Neptune

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 permintaan yang sedang berjalan atau menunggu.

Parameter untuk permintaan status

Parameter kueri status
  • includeWaiting(trueataufalse) — Ketika disetel ke true dan parameter lain tidak ada, menyebabkan informasi status untuk permintaan menunggu dikembalikan serta untuk menjalankan kueri.

  • cancelQuery— Digunakan hanya dengan GET dan POST metode, untuk menunjukkan bahwa ini adalah permintaan pembatalan. DELETEMetode ini tidak memerlukan parameter ini.

    Nilai cancelQuery parameter tidak digunakan, tetapi ketika cancelQuery ada, queryId parameter diperlukan, untuk mengidentifikasi kueri mana yang akan dibatalkan.

  • queryId— Berisi ID dari kueri tertentu.

    Ketika digunakan dengan POST metode GET or dan cancelQuery parameter tidak ada, queryId menyebabkan informasi status dikembalikan untuk kueri spesifik yang diidentifikasi. Jika cancelQuery parameter ada, maka kueri spesifik yang queryId 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.

    • dibatalkanTrue menunjukkan bahwa kueri dibatalkan, atau False belum dibatalkan.

Contoh permintaan dan tanggapan status

  • Permintaan status semua pertanyaan, termasuk yang menunggu:

    AWS CLI
    aws neptunedata get-open-cypher-query-status \ --endpoint-url https://your-neptune-endpoint:port \ --include-waiting

    Untuk informasi selengkapnya, lihat get-open-cypher-query-status di Referensi AWS CLI Perintah.

    SDK
    import boto3 from botocore.config import Config client = boto3.client( 'neptunedata', endpoint_url='https://your-neptune-endpoint:port', config=Config(read_timeout=None, retries={'total_max_attempts': 1}) ) response = client.get_open_cypher_query_status( includeWaiting=True ) print(response)

    Untuk contoh AWS SDK dalam bahasa lain, lihatAWS SDK.

    awscurl
    awscurl https://your-neptune-endpoint:port/openCypher/status \ --region us-east-1 \ --service neptune-db \ -X POST \ -d "includeWaiting=true"
    catatan

    Contoh ini mengasumsikan bahwa AWS kredensil Anda dikonfigurasi di lingkungan Anda. Ganti us-east-1 dengan Wilayah cluster Neptunus Anda.

    curl
    curl https://your-neptune-endpoint:port/openCypher/status \ --data-urlencode "includeWaiting=true"

    Tanggapan:

    { "acceptedQueryCount" : 0, "runningQueryCount" : 0, "queries" : [ ] }
  • Meminta status kueri yang sedang berjalan, tidak termasuk yang menunggu::

    AWS CLI
    aws neptunedata get-open-cypher-query-status \ --endpoint-url https://your-neptune-endpoint:port

    Untuk informasi selengkapnya, lihat get-open-cypher-query-status di Referensi AWS CLI Perintah.

    SDK
    import boto3 from botocore.config import Config client = boto3.client( 'neptunedata', endpoint_url='https://your-neptune-endpoint:port', config=Config(read_timeout=None, retries={'total_max_attempts': 1}) ) response = client.get_open_cypher_query_status() print(response)

    Untuk contoh AWS SDK dalam bahasa lain, lihatAWS SDK.

    awscurl
    awscurl https://your-neptune-endpoint:port/openCypher/status \ --region us-east-1 \ --service neptune-db
    catatan

    Contoh ini mengasumsikan bahwa AWS kredensil Anda dikonfigurasi di lingkungan Anda. Ganti us-east-1 dengan Wilayah cluster Neptunus Anda.

    curl
    curl https://your-neptune-endpoint:port/openCypher/status

    Tanggapan:

    { "acceptedQueryCount" : 0, "runningQueryCount" : 0, "queries" : [ ] }
  • Permintaan status kueri tunggal:

    AWS CLI
    aws neptunedata get-open-cypher-query-status \ --endpoint-url https://your-neptune-endpoint:port \ --query-id eadc6eea-698b-4a2f-8554-5270ab17ebee

    Untuk informasi selengkapnya, lihat get-open-cypher-query-status di Referensi AWS CLI Perintah.

    SDK
    import boto3 from botocore.config import Config client = boto3.client( 'neptunedata', endpoint_url='https://your-neptune-endpoint:port', config=Config(read_timeout=None, retries={'total_max_attempts': 1}) ) response = client.get_open_cypher_query_status( queryId='eadc6eea-698b-4a2f-8554-5270ab17ebee' ) print(response)

    Untuk contoh AWS SDK dalam bahasa lain, lihatAWS SDK.

    awscurl
    awscurl https://your-neptune-endpoint:port/openCypher/status \ --region us-east-1 \ --service neptune-db \ -X POST \ -d "queryId=eadc6eea-698b-4a2f-8554-5270ab17ebee"
    catatan

    Contoh ini mengasumsikan bahwa AWS kredensil Anda dikonfigurasi di lingkungan Anda. Ganti us-east-1 dengan Wilayah cluster Neptunus Anda.

    curl
    curl https://your-neptune-endpoint: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

    AWS CLI
    aws neptunedata cancel-open-cypher-query \ --endpoint-url https://your-neptune-endpoint:port \ --query-id f43ce17b-db01-4d37-a074-c76d1c26d7a9

    Untuk informasi selengkapnya, lihat cancel-open-cypher-querydi Referensi AWS CLI Perintah.

    SDK
    import boto3 from botocore.config import Config client = boto3.client( 'neptunedata', endpoint_url='https://your-neptune-endpoint:port', config=Config(read_timeout=None, retries={'total_max_attempts': 1}) ) response = client.cancel_open_cypher_query( queryId='f43ce17b-db01-4d37-a074-c76d1c26d7a9' ) print(response)

    Untuk contoh AWS SDK dalam bahasa lain, lihatAWS SDK.

    awscurl
    awscurl https://your-neptune-endpoint:port/openCypher/status \ --region us-east-1 \ --service neptune-db \ -X POST \ -d "cancelQuery" \ -d "queryId=f43ce17b-db01-4d37-a074-c76d1c26d7a9"
    catatan

    Contoh ini mengasumsikan bahwa AWS kredensil Anda dikonfigurasi di lingkungan Anda. Ganti us-east-1 dengan Wilayah cluster Neptunus Anda.

    curl

    1. MenggunakanPOST :

    curl -X POST https://your-neptune-endpoint:port/openCypher/status \ --data-urlencode "cancelQuery" \ --data-urlencode "queryId=f43ce17b-db01-4d37-a074-c76d1c26d7a9"

    2. MenggunakanGET :

    curl -X GET https://your-neptune-endpoint:port/openCypher/status \ --data-urlencode "cancelQuery" \ --data-urlencode "queryId=588af350-cfde-4222-bee6-b9cedc87180d"

    3. MenggunakanDELETE :

    curl -X DELETE \ "https://your-neptune-endpoint:port/openCypher/status?queryId=b9a516d1-d25c-4301-bb80-10b2743ecf0e"

    Tanggapan:

    { "status" : "200 OK", "payload" : true }