

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

# Amazon Neptune 클러스터에 연결
<a name="get-started-connecting"></a>

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

## 네트워크 연결 옵션
<a name="get-started-connect-ways"></a>

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

다음과 같은 여러 가지 방법으로 VPC의 Neptune DB 클러스터에 대한 네트워크 액세스를 설정할 수 있습니다.
+ [동일한 VPC에 있는 Amazon EC2 인스턴스에서 연결](get-started-connect-ec2-same-vpc.md)
+ [다른 VPC의 Amazon EC2 인스턴스에서 연결](get-started-connect-ec2-other-vpc.md)
+ [프라이빗 네트워크에서 연결](get-started-connect-private-net.md)
+ [퍼블릭 엔드포인트로부터 연결](neptune-public-endpoints.md)

## 연결 확인
<a name="get-started-verify-connection"></a>

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

------
#### [ AWS CLI ]

다음 명령을 실행합니다.

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

자세한 내용은 AWS CLI 명령 참조의 [get-engine-status](https://docs.aws.amazon.com/cli/latest/reference/neptunedata/get-engine-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=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 클러스터에 안전하게 연결](iam-auth-connect-command-line.md#iam-auth-connect-awscurl).

------
#### [ 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에 대한 액세스 보호](get-started-security.md) 단원을 참조하십시오. AWS CLI, SDKs[명령줄 도구 사용](get-started-cli-tools.md). `curl` 