

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
<a name="access-graph-opencypher-status"></a>

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
<a name="access-graph-opencypher-status-parameters"></a>

**Parameter kueri status**
+ **`includeWaiting`**(`true`atau`false`) — 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. `DELETE`Metode 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 ke`true`, menyebabkan pembatalan terjadi secara diam-diam.

## Bidang respons permintaan status
<a name="access-graph-opencypher-status-response-fields"></a>

**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](features-query-id.md)).
+ **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, atau `False` belum dibatalkan.

## Contoh permintaan dan tanggapan status
<a name="access-graph-opencypher-status-samples"></a>
+ **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/status
  ```

  *Tanggapan:*

  ```
  {
    "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
  }
  ```