Gremlin クエリのステータス API - Amazon Neptune
リクエストパラメータレスポンスの構文レスポンス値例

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

Gremlin クエリのステータス API

Gremlin クエリのステータスを取得するには、 HTTPGETまたは POST を使用してhttps://your-neptune-endpoint:port/gremlin/statusエンドポイントにリクエストを行います。

Gremlin クエリステータスのリクエストパラメータ

  • queryId (オプション ) – 実行中の Gremlin クエリの ID。指定したクエリのステータスのみを表示します。

  • includeWaiting (オプション ) – 待機中のすべてのクエリのステータスを返します。

    通常、実行中のクエリだけが応答に含まれますが、includeWaiting パラメータを指定すると、待機中のすべてのクエリのステータスも返されます。

Gremlin クエリステータスのレスポンスの構文

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

Gremlin クエリステータスのレスポンス値

  • acceptedQueryCount – キュー内のクエリを含め、受け入れられたがまだ完了していないクエリの数。

  • runningQueryCount – 現在実行中の Gremlin クエリの数。

  • queries   –   現在の Gremlin クエリのリスト。

  • queryId – クエリの GUID ID。Neptune は、この ID 値を各クエリに自動的に割り当てます。または、独自の ID を割り当てることもできます (Neptune Gremlin またはクエリにカスタム ID を挿入SPARQLするを参照)。

  • queryEvalStats – このクエリの統計。

  • subqueries — このクエリのサブクエリの数。

  • elapsed   –   これまでクエリが実行されていた時間 (マイクロ秒)。

  • cancelled   –   True はクエリがキャンセルされたことを示します。

  • queryString – 送信されたクエリ。それより長い場合、これは 1024 文字に切り捨てられます。

  • waited - クエリが待機していた時間をミリ秒単位で示します。

Gremlin クエリステータスの例

以下は、 curlと HTTP を使用したステータスコマンドの例ですGET。

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

この出力には、実行中の単一のクエリが表示されます。

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