Gremlin 查詢狀態 API

若要取得 Gremlin 查詢的狀態，請使用 HTTP GET 或 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 (請參閱 將自訂 ID 注入至 Neptune Gremlin 或 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()"
    }
  ]
}