小鬼查詢狀態 API

要獲取 Grimlin 查詢的狀態，請使用HTTPGET或POST向端點發出請求。https://your-neptune-endpoint:port/gremlin/status

Gremlin 查詢狀態請求參數

• queryId(選擇性) — 執行中的 Girmlin 查詢的識別碼。只顯示指定查詢的狀態。

• includeWaiting(選擇性) — 傳回所有等待中查詢的狀態。

  通常，回應中只包含執行中查詢，但是當指定 includeWaiting 參數時，也會傳回所有等待中查詢的狀態。

Gremlin 查詢狀態回應語法

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

Gremlin 查詢狀態回應值

• acceptedQueryCount— 已接受但尚未完成的查詢數目，包括佇列中的查詢。

• runningQueryCount— 當前正在運行的小鬼查詢的數量。

• queries – 目前的 Gremlin 查詢清單。

• queryId— 查詢的GUID識別碼。Neptune 會自動將此 ID 值指派給每個查詢，或者您也可以指派自己的 ID (請參閱 將自定義 ID 注入 Neptune 小鬼或查詢 SPARQL)。

• queryEvalStats— 此查詢的統計資料。

• subqueries – 此查詢中的子查詢數目。

• elapsed – 到目前為止查詢已執行的毫秒數。

• cancelled – True 表示查詢已取消。

• queryString— 提交的查詢。如果超過 1024 個字元即予截斷。

• waited – 指出查詢已等待多長時間 (以毫秒為單位)。

Gremlin 查詢狀態範例

以下是使用curl和的 status 命令的範例HTTPGET。

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()"
    }
  ]
}