

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# SPARQL クエリステータス API
<a name="sparql-api-status"></a>

SPARQL クエリのステータスを取得するには、HTTP `GET` または `POST` を使用して、`https://your-neptune-endpoint:port/sparql/status` エンドポイントにリクエストを送信します。

## SPARQL クエリステータスのリクエストパラメータ
<a name="sparql-api-status-get-request"></a>

**queryId (オプション)**  
実行中の SPARQL クエリの ID。指定したクエリのステータスのみを表示します。

## SPARQL クエリステータスのレスポンスの構文
<a name="sparql-api-status-get-response-syntax"></a>

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

## SPARQL クエリステータスのレスポンス値
<a name="sparql-api-status-get-response-values"></a>

**acceptedQueryCount**  
Neptune エンジンの最後の再起動以降に受け入れられたクエリの数。

**runningQueryCount**  
現在実行中の SPARQL クエリの数。

**クエリ**  
現在の SPARQL クエリのリスト。

**queryId**  
クエリの GUID ID。Neptune は、この ID 値を各クエリに自動的に割り当てます。または、独自の ID を割り当てることもできます ([Neptune Gremlin または SPARQL クエリにカスタム ID を挿入する](features-query-id.md)を参照)。

**queryEvalStats**  
このクエリの統計情報。

**subqueries**  
このクエリのサブクエリの数。

**elapsed**  
これまでクエリが実行されていた時間 (マイクロ秒)。

**キャンセル済み**  
True はクエリがキャンセルされたことを示します。

**queryString**  
送信されたクエリ。

## SPARQL クエリステータスの例
<a name="sparql-api-status-get-example"></a>

以下は、`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}"
        }
    ]
}
```