드라이버를 통해 연결
클러스터에 대한 Connect 대화 상자는 MongoDB 드라이버를 사용하는 애플리케이션으로 클러스터에 연결하기 위한 세부 정보를 제공합니다.
참고
현재 서버리스 인스턴스는 특정 드라이버 또는 드라이버 버전을 통한 연결을 지원하지 않습니다. 자세한 내용은 서버리스 인스턴스 제한 사항을 참조하세요.
Select your language 드롭다운 메뉴를 사용하여 이 페이지에서 예시의 언어를 설정합니다.
전제 조건
드라이버 버전
사용 중인 드라이버 버전이 사용 중인 MongoDB 서버 버전과 호환되어야 합니다. 최신 데이터베이스 기능을 사용하고 향후 버전 업그레이드에 대비하려면 사용 중인 MongoDB 서버 버전과 호환되는 최신 드라이버를 선택하는 것이 좋습니다.
사용 중인 MongoDB 서버 버전에 대한 전체 기능 세트가 포함된 드라이버 버전 목록은 사용 중인 MongoDB 드라이버의 호환성 매트릭스를 확인하세요.
서버리스 인스턴스에 연결하는 데 사용할 수 있는 드라이버 버전 목록의 경우 서버리스 인스턴스의 Minimum Driver Versions for Serverless Instances를 참조합니다.
비공개 엔드포인트를 통한 샤드 클러스터에 대해 최적화된 연결 문자열
드라이버 및 최적화된 연결 문자열을 사용하여 샤드 클러스터에 연결하려면 다음 드라이버 버전 중 하나 이상을 사용해야 합니다.
TLS
클라이언트가 Atlas 클러스터에 연결하려면 TLS 를 지원해야 합니다.
클라이언트는 SNI 를 M0 M2/M5 지원해야 합니다. Atlas 무료 클러스터 또는 공유 클러스터에 연결하기 위한 TLS 확장입니다. MongoDB 드라이버 가 SNI TLS 확장을 지원하는지 확인하려면 드라이버 설명서의 호환성 섹션을 참조하세요. 드라이버가 MongoDB 와 호환되는 4 경우.2 이상에서는 SNI TLS 확장을 지원합니다.
IP 액세스 목록
클러스터에 액세스하려면 Atlas 프로젝트의 IP 액세스 목록에 있는 IP 주소에서 연결해야 합니다. IP 액세스 목록에 IP 주소를 추가해야 하는 경우 Connect 대화 상자에서 추가할 수 있습니다. 네트워크 액세스 탭에서 IP 주소를 추가할 수도 있습니다.
데이터베이스 사용자
클러스터에 액세스하려면 Atlas 클러스터에서 원하는 데이터베이스에 대한 액세스 권한이 있는 데이터베이스 사용자 를 생성해야 합니다. 데이터베이스 사용자는 Atlas 사용자와는 별개입니다. 데이터베이스 사용자는 MongoDB 데이터베이스에 액세스할 수 있는 반면, Atlas 사용자는 Atlas 애플리케이션 자체에 액세스할 수 있습니다.
Connect 대화 상자에서 Atlas 클러스터에 액세스할 데이터베이스 사용자를 만들 수 있습니다. 클러스터 보기에서 데이터베이스 사용자를 추가할 수도 있습니다.
애플리케이션 연결
Atlas UI에서 클러스터를 선택합니다.
Atlas의 왼쪽 상단 모서리에서 Database를 클릭합니다.
Clusters 보기에서는 연결하고자 하는 클러스터에 대해 Connect 클릭합니다.
Connection Security를 선택합니다.
Choose Connection Type 사용 가능한 버튼 세트에서.
참고
기능이 허용된 경우 옵션이 표시됩니다.
Private IP for Peering, Private Endpoint 혹은 모두를 허용하면 Atlas에 연결 유형 옵션이 표시됩니다. 두 기능 중 하나를 허용하지 않은 경우 버튼이 표시되지 않고 Connection Type 기본값은 Standard로 설정됩니다.
클러스터에 대한 연결을 제한하는 방법을 선택합니다.
데이터베이스 사용자를 생성합니다.
중요
Setup connection security 단계에서 프로젝트에 데이터베이스 사용자가 하나 이상 구성되어 있다고 Atlas에서 표시하는 경우 이 단계를 건너뛰세요. 기존 데이터베이스 사용자를 관리하려면 데이터베이스 사용자 구성을 참조하세요.
클러스터에 액세스하려면 프로젝트의 클러스터에서 원하는 데이터베이스에 대한 액세스 권한이 있는 MongoDB 사용자가 필요합니다. 프로젝트에 MongoDB 사용자가 없는 경우 Atlas는 Atlas Admin 역할이 있는 새 사용자를 생성하라는 메시지를 표시합니다.
새로운 사용자의 Username을(를) 입력합니다.
이 새 사용자에 대한 Password를 입력하거나 Autogenerate Secure Password를 클릭합니다.
사용자를 저장하려면 Create Database User 을(를) 클릭합니다.
다음 단계에서 이 사용자를 사용하여 cluster에 연결합니다.
IP 액세스 목록에 IP 주소를 추가하고 데이터베이스 사용자를 추가한 경우 Choose Your Connection Method 을(를) 클릭합니다.
Drivers을 선택합니다.
Choose a connection method 단계에서 Drivers를 선택합니다.
드라이버 및 버전을 선택합니다.
드롭다운 메뉴에서 드라이버와 버전을 선택합니다. 연결 문자열이 포함된 코드 샘플이 표시됩니다. <password>를 데이터베이스 사용자를 만들 때 지정한 비밀번호로 바꿉니다.
참고
비밀번호, 데이터베이스 이름 또는 연결 문자열에 예약된 URI 문자가 포함된 경우 해당 문자를 이스케이프 처리해야 합니다. 예를 들어 비밀번호가 @bc123인 경우 연결 문자열에 암호를 지정할 때 @ 문자를 이스케이프 처리해야 합니다 (예: %40bc123). 자세한 내용은 연결 문자열 비밀번호의 특수 문자를 참조하세요.
자세한 내용은 드라이버 호환성을 참조하세요.
드라이버 예제
다음 예제에서는 URI 연결 문자열 을 사용하여 Atlas cluster를 인증하고 연결합니다. 예제의 자리 표시자를 자격 증명 및 배포 세부 정보로 바꿉니다.
문제 해결
클러스터에 연결하는 데 문제가 있는 경우 연결 문제 해결을 참조하세요.