View a markdown version of this page

API status kueri Gremlin - Amazon Neptune
Permintaan daftarStatus kueri tunggal

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

API status kueri Gremlin

Anda dapat mencantumkan semua kueri Gremlin aktif atau mendapatkan status kueri tertentu. Titik akhir HTTP yang mendasari untuk kedua operasi adalahhttps://your-neptune-endpoint:port/gremlin/status.

Mendaftarkan kueri Gremlin aktif

Untuk mencantumkan semua kueri Gremlin aktif, panggil titik akhir tanpa queryId parameter.

Permintaan parameter

  • includeWaiting (opsional) — Jika disetel keTRUE, respons mencakup kueri menunggu selain menjalankan kueri.

Sintaksis Respons

{
  "acceptedQueryCount": integer,
  "runningQueryCount": integer,
  "queries": [
    {
      "queryId": "guid",
      "queryEvalStats": {
        "waited": integer,
        "elapsed": integer,
        "cancelled": boolean
      },
      "queryString": "string"
    }
  ]
}

  • diterima QueryCount — Jumlah kueri yang telah diterima tetapi belum selesai, termasuk kueri dalam antrian.

  • running QueryCount — Jumlah kueri Gremlin yang sedang berjalan.

  • queries — Daftar kueri Gremlin saat ini.

Contoh

AWS CLI
aws neptunedata list-gremlin-queries \
  --endpoint-url https://your-neptune-endpoint:port

Untuk informasi selengkapnya, lihat list-gremlin-query di Referensi Perintah. AWS CLI

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.list_gremlin_queries()

print(response)

Untuk contoh AWS SDK dalam bahasa lain seperti Java, .NET, dan lainnya, lihatAWS SDK.

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

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

Untuk informasi selengkapnya tentang penggunaan awscurl dengan otentikasi IAM, lihatMenggunakan awscurl dengan kredenSIAL sementara untuk terhubung dengan aman ke cluster DB dengan otentikasi IAM diaktifkan.

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

Output berikut menunjukkan satu kueri yang sedang berjalan.

{
  "acceptedQueryCount": 9,
  "runningQueryCount": 1,
  "queries": [
    {
      "queryId": "fb34cd3e-f37c-4d12-9cf2-03bb741bf54f",
      "queryEvalStats": {
        "waited": 0,
        "elapsed": 23,
        "cancelled": false
      },
      "queryString": "g.V().out().count()"
    }
  ]
}

Mendapatkan status query Gremlin tertentu

Untuk mendapatkan status query Gremlin tertentu, berikan parameter. queryId

Permintaan parameter

Sintaksis Respons

{
  "queryId": "guid",
  "queryString": "string",
  "queryEvalStats": {
    "waited": integer,
    "elapsed": integer,
    "cancelled": boolean,
    "subqueries": document
  }
}

  • QueryId — ID dari query.

  • queryString — Query yang dikirimkan. Ini dipotong menjadi 1024 karakter jika lebih panjang dari itu.

  • query EvalStats — Statistik untuk kueri, termasuk waited (waktu tunggu dalam milidetik), elapsed (waktu berjalan dalam milidetik), cancelled (apakah kueri dibatalkan), dan subqueries (jumlah subkueri).

Contoh

AWS CLI
aws neptunedata get-gremlin-query-status \
  --endpoint-url https://your-neptune-endpoint:port \
  --query-id "fb34cd3e-f37c-4d12-9cf2-03bb741bf54f"

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

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_gremlin_query_status(
    queryId='fb34cd3e-f37c-4d12-9cf2-03bb741bf54f'
)

print(response)

Untuk contoh AWS SDK dalam bahasa lain seperti Java, .NET, dan lainnya, lihatAWS SDK.

awscurl
awscurl https://your-neptune-endpoint:port/gremlin/status/fb34cd3e-f37c-4d12-9cf2-03bb741bf54f \
  --region us-east-1 \
  --service neptune-db
catatan

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

Untuk informasi selengkapnya tentang penggunaan awscurl dengan otentikasi IAM, lihatMenggunakan awscurl dengan kredenSIAL sementara untuk terhubung dengan aman ke cluster DB dengan otentikasi IAM diaktifkan.

curl
curl https://your-neptune-endpoint:port/gremlin/status/fb34cd3e-f37c-4d12-9cf2-03bb741bf54f

Berikut ini adalah contoh respons.

{
  "queryId": "fb34cd3e-f37c-4d12-9cf2-03bb741bf54f",
  "queryString": "g.V().out().count()",
  "queryEvalStats": {
    "waited": 0,
    "elapsed": 23,
    "cancelled": false
  }
}