기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# 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**  
이 쿼리에 대한 통계.

**하위 쿼리**  
이 쿼리에 있는 하위 쿼리의 수.

**Elapsed**  
지금까지 쿼리가 실행된 시간(단위: 밀리초).

**cancelled**  
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}"
        }
    ]
}
```