기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# Gremlin 쿼리 상태 API
모든 활성 Gremlin 쿼리를 나열하거나 특정 쿼리의 상태를 가져올 수 있습니다. 두 작업의 기본 HTTP 엔드포인트는 입니다`https://{{your-neptune-endpoint}}:{{port}}/gremlin/status`.
## 활성 Gremlin 쿼리 나열
모든 활성 Gremlin 쿼리를 나열하려면 `queryId` 파라미터 없이 엔드포인트를 호출합니다.
### 요청 파라미터
+ **includeWaiting**(*선택 사항*) - 로 설정 하면 응답`TRUE`에 쿼리 실행 외에도 대기 중인 쿼리가 포함됩니다.
### 응답 구문
```
{
"acceptedQueryCount": integer,
"runningQueryCount": integer,
"queries": [
{
"queryId": "guid",
"queryEvalStats": {
"waited": integer,
"elapsed": integer,
"cancelled": boolean
},
"queryString": "string"
}
]
}
```
+ **acceptedQueryCount** – 대기열에 있는 쿼리를 포함하여 수락되었지만 아직 완료되지 않은 쿼리 수입니다.
+ **runningQueryCount** – 현재 실행 중인 Gremlin 쿼리의 수입니다.
+ **queries** – 현재 Gremlin 쿼리 목록입니다.
### 예제
------
#### [ AWS CLI ]
```
aws neptunedata list-gremlin-queries \
--endpoint-url https://{{your-neptune-endpoint}}:{{port}}
```
자세한 내용은 AWS CLI 명령 참조의 [list-gremlin-queries](https://docs.aws.amazon.com/cli/latest/reference/neptunedata/list-gremlin-queries.html)를 참조하세요.
------
#### [ SDK ]
```
import boto3
from botocore.config import Config
client = boto3.client(
'neptunedata',
endpoint_url='https://{{your-neptune-endpoint}}:{{port}}',
config=Config(read_timeout=None, retries={'total_max_attempts': 1})
)
response = client.list_gremlin_queries()
print(response)
```
Java, .NET 등과 같은 다른 언어의 AWS SDK 예제는 섹션을 참조하세요[AWS SDK](access-graph-gremlin-sdk.md).
------
#### [ awscurl ]
```
awscurl https://{{your-neptune-endpoint}}:{{port}}/gremlin/status \
--region {{us-east-1}} \
--service neptune-db
```
**참고**
이 예제에서는 자격 AWS 증명이 환경에 구성되어 있다고 가정합니다. {{us-east-1}}을 Neptune 클러스터의 리전으로 바꿉니다.
IAM 인증과 **awscurl** 함께를 사용하는 방법에 대한 자세한 내용은 섹션을 참조하세요[임시 보안 인증 정보와 `awscurl`을 사용하여 IAM 인증이 활성화된 상태에서 DB 클러스터에 안전하게 연결](iam-auth-connect-command-line.md#iam-auth-connect-awscurl).
------
#### [ curl ]
```
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()"
}
]
}
```
## 특정 Gremlin 쿼리의 상태 가져오기
특정 Gremlin 쿼리의 상태를 가져오려면 `queryId` 파라미터를 제공합니다.
### 요청 파라미터
+ **queryId**(*필수*) - Gremlin 쿼리의 ID입니다. Neptune은 각 쿼리에이 ID 값을 자동으로 할당하거나 고유한 ID를 할당할 수 있습니다( 참조[Neptune Gremlin 또는 SPARQL 쿼리에 사용자 지정 ID 주입](features-query-id.md)).
### 응답 구문
```
{
"queryId": "guid",
"queryString": "string",
"queryEvalStats": {
"waited": integer,
"elapsed": integer,
"cancelled": boolean,
"subqueries": document
}
}
```
+ **queryId** - 쿼리의 ID입니다.
+ **queryString** – 제출된 쿼리입니다. 이보다 길면 1024자로 잘립니다.
+ **queryEvalStats** - (밀리초 단위의 대기 시간), `waited` (밀리초 단위의 `elapsed` 실행 시간), `cancelled` (쿼리가 취소되었는지 여부) 및 `subqueries` (하위 쿼리 수)를 포함한 쿼리에 대한 통계입니다.
### 예제
------
#### [ AWS CLI ]
```
aws neptunedata get-gremlin-query-status \
--endpoint-url https://{{your-neptune-endpoint}}:{{port}} \
--query-id "fb34cd3e-f37c-4d12-9cf2-03bb741bf54f"
```
자세한 내용은 AWS CLI 명령 참조의 [get-gremlin-query-status](https://docs.aws.amazon.com/cli/latest/reference/neptunedata/get-gremlin-query-status.html)를 참조하세요.
------
#### [ SDK ]
```
import boto3
from botocore.config import Config
client = boto3.client(
'neptunedata',
endpoint_url='https://{{your-neptune-endpoint}}:{{port}}',
config=Config(read_timeout=None, retries={'total_max_attempts': 1})
)
response = client.get_gremlin_query_status(
queryId='fb34cd3e-f37c-4d12-9cf2-03bb741bf54f'
)
print(response)
```
Java, .NET 등과 같은 다른 언어의 AWS SDK 예제는 섹션을 참조하세요[AWS SDK](access-graph-gremlin-sdk.md).
------
#### [ awscurl ]
```
awscurl https://{{your-neptune-endpoint}}:{{port}}/gremlin/status/fb34cd3e-f37c-4d12-9cf2-03bb741bf54f \
--region {{us-east-1}} \
--service neptune-db
```
**참고**
이 예제에서는 자격 AWS 증명이 환경에 구성되어 있다고 가정합니다. {{us-east-1}}을 Neptune 클러스터의 리전으로 바꿉니다.
IAM 인증과 **awscurl** 함께를 사용하는 방법에 대한 자세한 내용은 섹션을 참조하세요[임시 보안 인증 정보와 `awscurl`을 사용하여 IAM 인증이 활성화된 상태에서 DB 클러스터에 안전하게 연결](iam-auth-connect-command-line.md#iam-auth-connect-awscurl).
------
#### [ curl ]
```
curl https://{{your-neptune-endpoint}}:{{port}}/gremlin/status/fb34cd3e-f37c-4d12-9cf2-03bb741bf54f
```
------
다음은 응답의 예입니다.
```
{
"queryId": "fb34cd3e-f37c-4d12-9cf2-03bb741bf54f",
"queryString": "g.V().out().count()",
"queryEvalStats": {
"waited": 0,
"elapsed": 23,
"cancelled": false
}
}
```