기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# Amazon DocumentDB 엔드포인트에 대한 이해
Amazon DocumentDB(MongoDB와 호환됨) 엔드포인트를 사용하여 클러스터 또는 인스턴스에 연결할 수 있습니다. Amazon DocumentDB에는 각각 고유한 용도가 있는 세 가지 유형의 엔드포인트가 있습니다.
**Topics**
+ [클러스터 엔드포인트 찾기](db-cluster-endpoints-find.md)
+ [인스턴스의 엔드포인트 찾기](db-instance-endpoint-find.md)
+ [엔드포인트에 연결](endpoints-connecting.md)
**클러스터 엔드포인트**
클러스터 엔드포인트는 클러스터의 현재 기본 인스턴스에 연결되는 Amazon DocumentDB 클러스터의 엔드포인트입니다. 각 Amazon DocumentDB 클러스터 엔드포인트 하나와 기본 인스턴스 하나가 있습니다. 장애 조치의 경우 클러스터 엔드포인트가 새로운 기본 인스턴스에 다시 매핑됩니다.
**리더 엔드포인트**
리더 엔드포인트는 해당 클러스터에서 사용할 수 있는 복제본 중 하나에 연결되는 Amazon DocumentDB 클러스터의 엔드포인트입니다. 각 Amazon DocumentDB 클러스터에는 리더 엔드포인트가 1개씩 있습니다. 복제본이 둘 이상이면 리더 엔드포인트는 각 연결 요청을 Amazon DocumentDB 복제본 중 하나로 전달합니다.
**인스턴스 엔드포인트**
인스턴스 엔드포인트는 특정 인스턴스에 연결되는 엔드포인트입니다. 기본 인스턴스인지 복제본 인스턴스인지 여부에 상관없이 클러스터의 각 인스턴스에는 고유한 인스턴스 엔드포인트가 있습니다. 애플리케이션에서 인스턴스 엔드포인트를 사용하지 않는 것이 좋습니다. 왜냐하면 장애 조치를 실행하는 경우 역할을 변경할 수 있으므로 애플리케이션에서 코드 변경을 요구할 수 있기 때문입니다.
# 클러스터 엔드포인트 찾기
Amazon DocumentDB 콘솔 또는 AWS CLI를 사용하여 클러스터의 클러스터 엔드포인트와 리더 엔드포인트를 찾을 수 있습니다.
------
#### [ Using the AWS Management Console ]
**콘솔을 사용하여 클러스터의 엔드포인트 찾기:**
1. AWS Management Console에 로그인하고 [https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb)에서 Amazon DocumentDB 콘솔을 엽니다.
1. 탐색 창에서 **클러스터**를 선택합니다.
1. 클러스터 목록에서 원하는 클러스터 이름을 선택합니다.
1. 클러스터 세부 정보 페이지에서 **구성** 탭을 선택합니다. **구성 및 상태** 섹션에서 **클러스터 엔드포인트**와 **리더 엔드포인트**를 찾을 수 있습니다.
![\[클러스터 및 리더 엔드포인트를 보여주는 구성 및 상태 섹션.\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/db-cluster-endpoints.png)
1. 이 클러스터에 연결하려면 **연결 및 보안** 탭을 선택합니다. `mongo` 쉘에 대한 연결 문자열과 애플리케이션 코드에서 클러스터에 연결하는 데 사용할 수 있는 연결 문자열을 찾습니다.
![\[Mongo 쉘에서 인스턴스에 연결하는 문자열과 애플리케이션에서 클러스터에 연결하는 문자열을 보여주는 연결 섹션.\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/cluster-connection-strings.png)
------
#### [ Using the AWS CLI ]
AWS CLI를 사용하여 클러스터 및 클러스터에 대한 리더 엔드포인트를 찾으려면 `describe-db-clusters` 명령을 해당 파라미터와 함께 실행합니다.
**파라미터**
+ **--db-cluster-identifier**—선택 사항. 엔드포인트를 반환하려는 클러스터를 지정합니다. 생략한 경우 최대 100개의 클러스터에 대한 엔드포인트를 반환합니다.
+ **--query**—선택 사항. 표시할 필드를 지정합니다. 엔드포인트를 찾기 위해 볼 데이터의 양을 줄여서 도와줍니다. 생략하면 클러스터에 대한 모든 정보가 반환됩니다.
+ **--region**—선택 사항. `--region` 파라미터를 사용하여 명령을 적용할 리전을 지정합니다. 생략하면 기본 리전이 사용됩니다.
**Example**
다음 예에서는 `DBClusterIdentifier`에 대한 `ReaderEndpoint`, 엔드포인트(클러스터 엔드포인트) 및 `sample-cluster`를 반환합니다.
Linux, macOS, Unix의 경우:
```
aws docdb describe-db-clusters \
--region us-east-1 \
--db-cluster-identifier sample-cluster \
--query 'DBClusters[*].[DBClusterIdentifier,Port,Endpoint,ReaderEndpoint]'
```
Windows의 경우:
```
aws docdb describe-db-clusters ^
--region us-east-1 ^
--db-cluster-identifier sample-cluster ^
--query 'DBClusters[*].[DBClusterIdentifier,Port,Endpoint,ReaderEndpoint]'
```
이 작업의 출력은 다음과 같습니다(JSON 형식).
```
[
[
"sample-cluster",
27017,
"sample-cluster.cluster-corlsfccjozr.us-east-1.docdb.amazonaws.com",
"sample-cluster.cluster-ro-corlsfccjozr.us-east-1.docdb.amazonaws.com"
]
]
```
클러스터 엔드포인트가 있으므로 이제 `mongo` 또는 `mongodb`를 사용하여 클러스터에 연결할 수 있습니다. 자세한 내용은 [엔드포인트에 연결](endpoints-connecting.md) 섹션을 참조하세요.
------
# 인스턴스의 엔드포인트 찾기
Amazon DocumentDB 콘솔 또는 AWS CLI을 사용하여 인스턴스의 엔드포인트를 찾을 수 있습니다.
------
#### [ Using the AWS Management Console ]
**콘솔을 사용하여 인스턴스의 엔드포인트를 찾으려면**
1. AWS Management Console에 로그인한 후 [https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb)에서 Amazon DocumentDB 콘솔을 엽니다.
1. 탐색 창에서 **클러스터**를 선택합니다.
**작은 정보**
화면 왼쪽에 탐색 창이 표시되지 않으면 페이지 왼쪽 상단 모서리에서 메뉴 아이콘(![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/docdb-menu-icon.png))을 선택합니다.
1. 클러스터 탐색 상자에 **클러스터 식별자** 열이 표시됩니다. 인스턴스는 아래 스크린샷과 마찬가지로 클러스터 아래에 나열됩니다.
![\[클러스터 식별자 열 아래에 인스턴스가 클러스터 내에 중첩된 클러스터 목록을 보여주는 클러스터 테이블입니다.\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/choose-clusters.png)
1. 관심 있는 인스턴스의 왼쪽에 있는 확인란을 체크합니다.
1. 아래로 스크롤하여 **세부 정보** 섹션으로 이동한 다음 인스턴스 엔드포인트를 찾습니다.
![\[인스턴스 엔드포인트가 강조 표시된 세부 정보 페이지를 보여주는 콘솔 스크린샷입니다.\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/db-instance-endpoint.png)
1. 이 인스턴스에 연결하려면 위로 스크롤하여 **연결** 섹션으로 이동합니다. `mongo` 쉘에 대한 연결 문자열과 애플리케이션 코드에서 인스턴스에 연결하는 데 사용할 수 있는 연결 문자열을 찾습니다.
![\[Mongo 쉘 및 애플리케이션 연결 문자열이 강조 표시된 연결 섹션을 보여주는 콘솔 스크린샷입니다.\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/instance-connection-strings.png)
------
#### [ Using the AWS CLI ]
AWS CLI를 사용하여 인스턴스 엔드포인트를 찾으려면 다음 명령을 해당 인수와 함께 실행합니다.
**인수**
+ **--db-instance-identifier**—선택 사항. 엔드포인트를 반환하려는 인스턴스를 지정합니다. 생략한 경우 최대 100개의 인스턴스에 대한 엔드포인트를 반환합니다.
+ **--query**—선택 사항. 표시할 필드를 지정합니다. 엔드포인트를 찾기 위해 볼 데이터의 양을 줄여서 도와줍니다. 생략하면 인스턴스에 대한 모든 정보가 반환됩니다. `Endpoint` 필드에는 세 개의 멤버가 있습니다. 따라서 다음 예제와 같이 쿼리에 나열하면 세 멤버가 모두 반환됩니다. `Endpoint` 멤버 중 일부에만 관심이 있는 경우 두 번째 예제와 같이 쿼리의 `Endpoint`를 원하는 멤버로 교체하세요.
+ **--region**—선택 사항. `--region` 파라미터를 사용하여 명령을 적용할 리전을 지정합니다. 생략하면 기본 리전이 사용됩니다.
**Example**
Linux, macOS, Unix의 경우:
```
aws docdb describe-db-instances \
--region us-east-1 \
--db-instance-identifier sample-cluster-instance \
--query 'DBInstances[*].[DBInstanceIdentifier,Endpoint]'
```
Windows의 경우:
```
aws docdb describe-db-instances ^
--region us-east-1 ^
--db-instance-identifier sample-cluster-instance ^
--query 'DBInstances[*].[DBInstanceIdentifier,Endpoint]'
```
이 작업의 출력은 다음과 같습니다(JSON 형식).
```
[
[
"sample-cluster-instance",
{
"Port": 27017,
"Address": "sample-cluster-instance.corcjozrlsfc.us-east-1.docdb.amazonaws.com",
"HostedZoneId": "Z2R2ITUGPM61AM"
}
]
]
```
엔드포인트의 `HostedZoneId`를 제거하기 위해 출력을 줄이고 `Endpoint.Port` 및 `Endpoint.Address`를 지정하여 쿼리를 수정할 수 있습니다.
Linux, macOS, Unix의 경우:
```
aws docdb describe-db-instances \
--region us-east-1 \
--db-instance-identifier sample-cluster-instance \
--query 'DBInstances[*].[DBInstanceIdentifier,Endpoint.Port,Endpoint.Address]'
```
Windows의 경우:
```
aws docdb describe-db-instances ^
--region us-east-1 ^
--db-instance-identifier sample-cluster-instance ^
--query 'DBInstances[*].[DBInstanceIdentifier,Endpoint.Port,Endpoint.Address]'
```
이 작업의 출력은 다음과 같습니다(JSON 형식).
```
[
[
"sample-cluster-instance",
27017,
"sample-cluster-instance.corcjozrlsfc.us-east-1.docdb.amazonaws.com"
]
]
```
인스턴스 엔드포인트가 있으므로 이제 `mongo` 또는 `mongodb`를 사용하여 인스턴스에 연결할 수 있습니다. 자세한 내용은 [엔드포인트에 연결](endpoints-connecting.md) 섹션을 참조하세요.
------
# 엔드포인트에 연결
엔드포인트(클러스터 또는 인스턴스)가 있는 경우 `mongo` 쉘 또는 연결 문자열을 사용하여 엔드포인트에 연결할 수 있습니다.
## mongo 쉘을 사용하여 연결
다음 구조를 사용하면 `mongo` 쉘을 사용하여 클러스터 또는 인스턴스에 연결하는 데 필요한 문자열을 작성할 수 있습니다.
```
mongo \
--ssl \
--host Endpoint:Port \
--sslCAFile global-bundle.pem \
--username UserName \
--password Password
```
**`mongo` 쉘 예**
클러스터에 연결:
```
mongo \
--ssl \
--host sample-cluster.corcjozrlsfc.us-east-1.docdb.amazonaws.com:27017 \
--sslCAFile global-bundle.pem \
--username UserName \
--password Password
```
인스턴스에 연결:
```
mongo \
--ssl \
--host sample-cluster-instance.corcjozrlsfc.us-east-1.docdb.amazonaws.com:27017 \
--sslCAFile global-bundle.pem \
--username UserName \
--password Password
```
## 연결 문자열을 사용하여 연결
다음 구조를 사용하면 클러스터 또는 인스턴스에 연결하는 데 필요한 연결 문자열을 작성할 수 있습니다.
```
mongodb://UserName:Password@endpoint:port?replicaSet=rs0&ssl_ca_certs=global-bundle.pem
```
**연결 문자열 예**
클러스터에 연결:
```
mongodb://UserName:Password@sample-cluster.cluster-corlsfccjozr.us-east-1.docdb.amazonaws.com:27017?replicaSet=rs0&ssl_ca_certs=global-bundle.pem
```
인스턴스에 연결:
```
mongodb://UserName:Password@sample-cluster-instance.cluster-corlsfccjozr.us-east-1.docdb.amazonaws.com:27017?replicaSet=rs0&ssl_ca_certs=global-bundle.pem
```