View a markdown version of this page

Gremlin 쿼리 상태 API - Amazon Neptune
쿼리 나열단일 쿼리 상태

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

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를 참조하세요.

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.

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 클러스터에 안전하게 연결.

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": "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를 참조하세요.

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.

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 클러스터에 안전하게 연결.

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
  }
}