Gremlin 查询状态 API - Amazon Neptune
请求参数响应语法响应值示例
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

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