本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
Gremlin 查询状态 API
您可以列出所有活跃的 Gremlin 查询或获取特定查询的状态。这两个操作的底层 HTTP 端点是 https://。your-neptune-endpoint:port/gremlin/status
列出活跃的 Gremlin 查询
要列出所有活跃的 Gremlin 查询,请调用不带 no 的端点 queryId 参数。
请求参数
-
包括等待 (可选的) — 如果设置为
TRUE,除了正在运行的查询外,响应还包括等待的查询。
响应语法
{ "acceptedQueryCount": integer, "runningQueryCount": integer, "queries": [ { "queryId": "guid", "queryEvalStats": { "waited": integer, "elapsed": integer, "cancelled": boolean }, "queryString": "string" } ] }
-
接受的QueryCount — 已接受但尚未完成的查询的数量,包括队列中的查询。
-
正在运行QueryCount — 当前正在运行的 Gremlin 查询的数量。
-
queries – 当前 Gremlin 查询的列表。
示例
以下输出显示了一个正在运行的查询。
{ "acceptedQueryCount": 9, "runningQueryCount": 1, "queries": [ { "queryId": "fb34cd3e-f37c-4d12-9cf2-03bb741bf54f", "queryEvalStats": { "waited": 0, "elapsed": 23, "cancelled": false }, "queryString": "g.V().out().count()" } ] }
获取特定 Gremlin 查询的状态
要获取特定 Gremlin 查询的状态,请提供 queryId 参数。
请求参数
-
QueryID (规定的) — Gremlin 查询的 ID。Neptune 会自动将此 ID 值分配给每个查询,或者您可以分配自己的 ID(参见 将自定义 ID 注入到 Neptune Gremlin 或 SPARQL 查询中)。
响应语法
{ "queryId": "guid", "queryString": "string", "queryEvalStats": { "waited": integer, "elapsed": integer, "cancelled": boolean, "subqueries": document } }
-
QueryID — 查询的 ID。
-
queryString – 提交的查询。在超过 1024 个字符时,将截断为此长度。
-
询问EvalStats — 查询的统计信息,包括
waited(以毫秒为单位的等待时间),elapsed(以毫秒为单位的运行时间),cancelled(查询是否已取消),以及subqueries(子查询的数量)。
示例
以下为响应示例。
{ "queryId": "fb34cd3e-f37c-4d12-9cf2-03bb741bf54f", "queryString": "g.V().out().count()", "queryEvalStats": { "waited": 0, "elapsed": 23, "cancelled": false } }