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

Amazon Neptune 클러스터에 연결

Neptune 클러스터를 생성한 후에는 애플리케이션이 클러스터 엔드포인트에 도달할 수 있도록 네트워크 액세스를 설정해야 합니다. 다음 섹션에서는 네트워크 연결 옵션에 대해 설명합니다. 연결 후 데이터 쿼리에 대한 자세한 내용은 섹션을 참조하세요그래프 데이터에 액세스.

네트워크 연결 옵션

Amazon Neptune DB 클러스터는 Amazon Virtual Private Cloud(VPC)에서만 생성할 수 있습니다. DB 클러스터에 대해 Neptune 퍼블릭 엔드포인트를 활성화하고 설정하지 않는 한 엔드포인트는 해당 VPC 내에서만 액세스할 수 있습니다.

다음과 같은 여러 가지 방법으로 VPC의 Neptune DB 클러스터에 대한 네트워크 액세스를 설정할 수 있습니다.

연결 확인

네트워크 액세스를 설정한 후 인스턴스 상태 엔드포인트를 호출하여 연결이 작동하는지 확인할 수 있습니다. 응답이 성공하면 클라이언트가 Neptune 클러스터에 도달할 수 있음을 확인합니다.

AWS CLI

다음 명령을 실행합니다.

aws neptunedata get-engine-status \
  --endpoint-url https://your-neptune-endpoint:port \
  --region us-east-1

자세한 내용은 AWS CLI 명령 참조의 get-engine-status를 참조하세요.

SDK

import boto3
from botocore.config import Config

client = boto3.client(
    'neptunedata',
    endpoint_url='https://your-neptune-endpoint:port',
    config=Config(read_timeout=10, retries={'total_max_attempts': 1})
)

response = client.get_engine_status()

print(response)

awscurl

awscurl https://your-neptune-endpoint:port/status \
  --region us-east-1 \
  --service neptune-db

참고

이 예제에서는 자격 AWS 증명이 환경에 구성되어 있다고 가정합니다. us-east-1을 Neptune 클러스터의 리전으로 바꿉니다.

IAM 인증과 awscurl 함께를 사용하는 방법에 대한 자세한 내용은 섹션을 참조하세요임시 보안 인증 정보와 awscurl을 사용하여 IAM 인증이 활성화된 상태에서 DB 클러스터에 안전하게 연결.

curl

다음 명령을 실행합니다.

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

참고

이 명령은 클러스터에서 IAM 인증이 활성화되지 않은 경우에만 작동합니다. IAM 인증이 활성화된 경우 awscurl 또는 AWS CLI 를 대신 사용합니다.

정상 클러스터는를 포함하는 JSON 응답을 반환합니다"status": "healthy". 예제:

{
    "status": "healthy",
    "startTime": "Thu Aug 24 21:07:13 UTC 2023",
    "dbEngineVersion": "1.3.1.0.R1",
    "role": "writer",
    "dfeQueryEngine": "viaQueryHint",
    "gremlin": { "version": "tinkerpop-3.7.2" },
    "sparql": { "version": "sparql-1.1" },
    "opencypher": { "version": "Neptune-9.0.20190305-1.0" },
    "labMode": { ... },
    "features": { ... },
    "settings": { ... }
}

엔드포인트에 연결할 수 없는 경우 네트워크 구성이 포트 8182(또는 구성된 포트)에서 트래픽을 허용하고 보안 그룹 규칙이 클라이언트로부터의 인바운드 연결을 허용하는지 확인합니다. 자세한 내용은 Neptune에 대한 액세스 보호 단원을 참조하십시오. AWS CLI, SDKs 또는 설정에 대한 도움말은 단원을 curl참조하십시오명령줄 도구 사용.