AI 에이전트의 경우: 문서 인덱스는 https://www.mongodb.com/ko-kr/docs/llms.txt에서 사용할 수 있으며, 모든 페이지의 마크다운 버전은 어떤 URL 경로에 .md를 추가하여 사용할 수 있습니다.
Docs Menu

클라이언트 라이브러리를 통해 클러스터에 연결

클러스터에 대한 Connect 대화 상자는 MongoDB 클라이언트 라이브러리를 사용하여 애플리케이션으로 클러스터에 연결하기 위한 세부 정보를 제공합니다.


Select your language 드롭다운 메뉴를 사용하여 이 페이지에서 예시의 언어를 설정합니다.


사용 중인 드라이버 버전이 사용 중인 MongoDB 서버 버전과 호환되어야 합니다. 최신 데이터베이스 기능을 사용하고 향후 버전 업그레이드에 대비하려면 사용 중인 MongoDB 서버 버전과 호환되는 최신 드라이버를 선택하는 것이 좋습니다.

사용 중인 MongoDB 서버 버전에 대한 전체 기능이 포함된 드라이버 버전 목록은 해당 드라이버의 클라이언트 라이브러리 호환성 표 를 확인하세요.

중요

공식 지원 드라이버

Use officially supported MongoDB drivers at current versions for the best reliability and support experience. The Atlas SLA covers officially supported drivers only.

Atlas는 Community 드라이버 및 지원 종료 드라이버 버전에 대해 최선의 노력을 다하여 진단만 지원합니다. Atlas는 Community 드라이버를 테스트하거나 패치하거나 인증하지 않습니다. 지원을 통해 연결 문제가 플랫폼에서 발생하는지 드라이버에서 발생하는지 확인할 수 있지만 드라이버 코드는 디버그하지 않습니다.

학습하려면 Atlas의 Community 및 지원되지 않는 드라이버에 대한 지원 정책은 무엇입니까?를 참조하세요.

운전자 와 최적화된 연결 문자열사용하여 샤딩된 클러스터 에 연결할 수 있습니다.

Atlas 클러스터에 연결하려면 클라이언트가 TLS를 지원해야 합니다.

Clients must support the SNI TLS extension to connect to an Atlas Free cluster (formerly known as M0) or Flex cluster.

클러스터에 액세스하려면 Atlas 프로젝트의 IP 액세스 목록에 있는 IP 주소에서 연결해야 합니다. IP 액세스 목록에 IP 주소를 추가해야 하는 경우 Connect 대화 상자에서 추가할 수 있습니다. 네트워크 액세스 탭에서 IP 주소를 추가할 수도 있습니다.

To access a cluster, you must have a database user with access to the desired databases on your Atlas cluster. Database users are separate from Atlas users. Database users have access to MongoDB databases, while Atlas users have access to the Atlas application itself.

Connect 대화 상자에서 Atlas 클러스터에 액세스할 데이터베이스 사용자를 생성할 수 있습니다. 클러스터 보기에서 데이터베이스 사용자를 추가할 수도 있습니다. Atlas는 첫 번째 클러스터를 생성할 때 데이터베이스 사용자를 생성합니다.

1
  1. 아직 표시되지 않은 경우 탐색 표시줄의 Organizations 메뉴에서 원하는 프로젝트가 포함된 조직을 선택합니다.

  2. 아직 표시되지 않은 경우 탐색 표시줄의 Projects 메뉴에서 원하는 프로젝트를 선택합니다.

  3. 사이드바에서 Database 제목 아래의 Clusters를 클릭합니다.

Clusters(클러스터) 페이지가 표시됩니다.

2

연결하려는 클러스터에 대해 Connect를 클릭합니다.

3

Choose Connection Type 사용 가능한 버튼 세트에서.

참고

기능이 허용된 경우 옵션이 표시됩니다.

Private IP for Peering, Private Endpoint 혹은 모두를 활성화하면 Atlas에 연결 유형 옵션이 표시됩니다. 두 기능 중 하나를 허용하지 않은 경우 버튼이 표시되지 않고 Connection Type 기본값은 Standard로 설정됩니다.

허용된 공개 IP 주소에 대해 이 연결 유형을 사용하십시오.

4

Add a Connection IP Address

중요

Setup connection security 단계에서 클러스터에 이미 IP 액세스 목록 항목을 구성했다고 Atlas가 표시하는 경우 이 단계를 건너뜁니다. IP 액세스 목록을 관리하려면 액세스 목록에 항목 추가를 참조하십시오.

Atlas는 프로젝트의 IP 액세스 목록 항목에서 클러스터에 대한 표준 클라이언트 연결을 허용합니다. 프로젝트 IP 액세스 목록은 특정 IP 또는 CIDR 주소로 API 액세스를 제한하는 API 액세스 목록과 다릅니다.

IP 액세스 목록이 비어 있으면 Atlas는 프로젝트의 IP 액세스 목록에 IP 주소를 추가하라는 메시지를 표시합니다. 둘 중 하나를 수행하면 됩니다.

  • 현재 IP 주소에서 액세스를 허용하려면 Add Your Current IP Address을 클릭합니다.

  • Add an IP Address을 클릭하여 단일 IP 주소 또는 CIDR로 표기된 주소 범위를 추가합니다.

새로 추가된 IP 주소 또는 CIDR 범위에 대한 선택적 설명을 제공합니다. Add IP Address을 클릭하여 IP 액세스 목록에 주소를 추가합니다.

5

중요

Setup connection security 단계에서 프로젝트에 데이터베이스 사용자가 하나 이상 구성되어 있다고 Atlas에서 표시하는 경우 이 단계를 건너뛰세요. 기존 데이터베이스 사용자를 관리하려면 데이터베이스 사용자 구성을 참조하세요.

To access the cluster, you need a MongoDB user with access to the desired database or databases on the cluster in your project. If your project has no MongoDB users, Atlas prompts you to create a new user with the Atlas Admin role.

  1. 새로운 사용자의 Username을(를) 입력합니다.

  2. 이 새 사용자에 대한 Password를 입력하거나 Autogenerate Secure Password를 클릭합니다.

  3. 사용자를 저장하려면 Create Database User 을(를) 클릭합니다.

다음 단계에서 이 사용자를 통해 클러스터에 연결합니다.

IP 액세스 목록에 IP 주소를 추가하고 데이터베이스 사용자를 추가한 경우 Choose Your Connection Method 을(를) 클릭합니다.

6

Choose a connection method 단계에서 Drivers를 선택합니다.

7

드롭다운 메뉴에서 드라이버와 버전을 선택합니다. 연결 문자열이 포함된 코드 샘플이 표시됩니다. <password>를 데이터베이스 사용자를 만들 때 지정한 비밀번호로 바꿉니다.

Use this connection string in your application 아래에서, 연결 문자열은 기본적으로 SRV 형식(mongodb+srv://)을 사용합니다. 표준(SRV 아닌) 연결 문자열(mongodb://)을 보려면 SRV Connection String 토글을 중지합니다.

참고

비밀번호, 데이터베이스 이름 또는 연결 문자열에 예약된 URI 문자가 포함된 경우 해당 문자를 이스케이프 처리해야 합니다. 예를 들어 비밀번호가 @bc123인 경우 연결 문자열에 암호를 지정할 때 @ 문자를 이스케이프 처리해야 합니다 (예시: %40bc123). 자세한 내용은 연결 문자열 비밀번호의 특수 문자를 참조하세요.

자세한 내용은 드라이버 호환성을 참조하세요.

In the following example, you authenticate and connect to an Atlas cluster by using a URI connection string. Replace the placeholders in the example with your credentials and deployment details.

참고

Atlas M0 무료 클러스터 또는 Flex 클러스터에 연결하려면 MongoDB 7.0 이상을 지원하는 C 드라이버 버전을 사용해야 합니다. C 드라이버와 MongoDB 간의 호환성에 대한 전체 문서는 MongoDB 호환성 매트릭스를 참조하세요. 드라이버를 최신 버전으로 업그레이드하는 것을 권장합니다.

client = mongoc_client_new ("mongodb+srv://<db_username>:<db_password>@<clusterName>.mongodb.net/?retryWrites=true&w=majority");
db = mongoc_client_get_database (client, "<databaseName>");
MongoDB 버전
권장 드라이버 버전

모두

See the MongoDB compatibility matrix for the latest recommended driver versions.

MongoDB 7.0 이상

버전 1.11 이상

참고

다음 구성 옵션은 C 운전자 단일 스레드 모드 로 실행 경우에만 적용 .

MongoDB 드라이버는 클러스터 투표 또는 페일오버 이벤트 후 자동으로 서버 선택을 시도합니다. 기본적으로 C 드라이버는 첫 번째 서버 선택 시도가 실패하면 즉시 오류를 발생시킵니다. 다음 구성 설정은 서버 선택 루프에서 더 많은 시간을 소비하는 대신 Atlas 클러스터에 대한 애플리케이션 연결을 개선할 수 있습니다.

  • Set serverSelectionTryOnce to false to direct the C driver to perform server selection up to the time limit defined by serverSelectionTimeoutMS.

  • Lower the serverSelectionTimeoutMS to 15000 from the default of 30000. MongoDB elections typically take 10 seconds, but can be as fast as 5 seconds on Atlas. Setting this value to 15 seconds (15000 milliseconds) covers the upper bound of election plus additional time for latency.

클러스터에 연결하는 데 문제가 있는 경우 연결 문제 해결을 참조하세요.