SPARQL 查询状态 API

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

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

要获取 SPARQL 查询的状态，请使用 HTTP GET 或 POST 来向 https://your-neptune-endpoint:port/sparql/status 终端节点提出请求。

SPARQL 查询状态请求参数

queryId（可选）

正在运行的 SPARQL 查询的 ID。仅显示指定查询的状态。

SPARQL 查询状态响应语法

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

SPARQL 查询状态响应值

acceptedQueryCount

自上次重启 Neptune 引擎以来接受的查询数。

runningQueryCount

当前正在运行的 SPARQL 查询数。

查询

当前 SPARQL 查询的列表。

queryId

查询的 GUID id。Neptune 为每个查询自动分配该 ID 值，或者您也可以分配自己的 ID（请参阅将自定义 ID 注入到 Neptune Gremlin 或 SPARQL 查询中）。

queryEvalStats

此查询的统计数据。

subqueries

此查询中的子查询数。

elapsed

到目前为止，查询已运行的毫秒数。

cancelled

True 指示查询已取消。

queryString

已提交的查询。

SPARQL 查询状态示例

以下是使用 curl 和 HTTP GET 的状态命令的示例。

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

此输出显示了一个正在运行的查询。

{
    "acceptedQueryCount":9,
    "runningQueryCount":1,
    "queries": [
        {
            "queryId":"fb34cd3e-f37c-4d12-9cf2-03bb741bf54f",
            "queryEvalStats":
                {
                    "subqueries": 0,
                    "elapsed": 29256,
                    "cancelled": false
                },
            "queryString": "SELECT ?s ?p ?o WHERE {?s ?p ?o}"
        }
    ]
}