Docs Menu
Docs Home
/
MongoDB Atlas
/ /

드라이버를 통해 연결

이 페이지의 내용

  • 전제 조건
  • 애플리케이션 연결
  • 드라이버 예시
  • 문제 해결

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

참고

현재 서버리스 인스턴스는 특정 드라이버 또는 드라이버 버전을 통한 연결을 지원하지 않습니다. 자세한 내용은 서버리스 인스턴스 제한 사항을 참조하세요.


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


중요

전용 클러스터 제한 사항

Linux에서 .NET 5.0을 사용해 C# 드라이버를 실행하는 경우, Atlas 전용 클러스터에서 MongoDB 4.0에 연결할 수 없습니다. 이 문제는 Atlas 전용 클러스터에만 적용되며, 클러스터 계층 M0~M5에는 영향을 주지 않습니다. 이전 .NET 또는 .NET Core 버전을 실행하고 있고 .NET 5.0으로 업그레이드하려는 경우MongoDB Atlas 지원팀에 문의하세요.

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

사용 중인 MongoDB 서버 버전에 대한 전체 기능 세트가 포함된 드라이버 버전 목록을 보려면 사용 중인 MongoDB 드라이버의 호환성 매트릭스를 확인하세요.

서버리스 인스턴스에 연결하는 데 사용할 수 있는 드라이버 버전 목록의 경우 서버리스 인스턴스의 Minimum Driver Versions for Serverless Instances를 참조합니다.

드라이버 및 최적화된 연결 문자열을 사용하여 샤딩된 클러스터에 연결하려면 다음 드라이버 버전 중 하나 이상을 사용해야 합니다.

드라이버
버전
1.19.0
3.7.0beta1
2.13.0
1.6.0
4.3.0
4.10.0
2.5.0
4.1.0
1.11.0 (Extension)
1.10.0 (Library)
3.12.0
2.16.0
2.1.0
4.3.0
1.2.0

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

클라이언트는 Atlas M0 무료 클러스터 또는 M2/M5 공유 클러스터에 연결하기 위해 SNI TLS 확장을 지원해야 합니다. MongoDB 드라이버SNI TLS 확장을 지원하는지 확인하려면 드라이버 설명서의 호환성 섹션을 참조하세요. 드라이버가 MongoDB 4.2 이상과 호환되는 경우 SNI TLS 확장을 지원합니다.

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

클러스터에 액세스하려면 Atlas 클러스터에서 원하는 데이터베이스에 대한 액세스 권한이 있는 데이터베이스 사용자 를 만들어야 합니다. 데이터베이스 사용자는 Atlas 사용자와는 별개입니다. 데이터베이스 사용자는 MongoDB 데이터베이스에 대한 액세스 권한이 있는 반면 Atlas 사용자는 Atlas 애플리케이션 자체에 대한 액세스 권한이 있습니다.

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

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

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

  3. 아직 표시되지 않은 경우 사이드바에서 Clusters를 클릭합니다.

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

2

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

3

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

참고

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

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

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

피어링을 사용하도록 설정한 경우 이 연결 유형을 사용합니다.

  • Google Cloud 또는 Azure의 경우 피어링된 네트워크에서 드라이버와 연결합니다. 또는

  • AWS의 경우 사용자 지정 DNS 서비스를 사용하는 피어링 네트워크에서 드라이버와 연결합니다.

이들 중 어느 것도 적용되지 않으면 IP 주소를 IP 액세스 목록에 추가하고 표준 연결 문자열을 사용하세요. 사무실이나 홈 네트워크에서 Atlas에 직접 연결하는 경우 이 옵션을 선호할 수 있습니다.

참고

피어를 사용할 수 있어야 합니다.

피어 중 한 명이 AVAILABLE로 표시되지 않는 한 이 옵션을 선택할 수 없습니다. 피어의 상태를 확인하려면 다음을 수행합니다.

Atlas에서 프로젝트의 Network Access 페이지로 이동합니다.

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

  2. 아직 표시되지 않은 경우 내비게이션 바의 Projects 메뉴에서 프로젝트를 선택합니다.

  3. 사이드바에서 Security 제목 아래의 Network Access를 클릭합니다.

    네트워크 액세스 페이지가 표시됩니다.

참고

멀티 클라우드 클러스터

애플리케이션이 클러스터의 프라이머리와 동일한 클라우드 서비스 제공자에서 호스팅되지 않는 경우 애플리케이션은 세컨더리 읽기만 수행할 수 있습니다.

멀티 클라우드 클러스터의 경우 연결 문자열readPreference 연결 옵션을 추가하는 것이 좋습니다. 다음 값 중 하나를 사용합니다.

드라이버가 다음과 같은 이유로 비공개 엔드포인트 연결을 통해 드라이버와 연결하는 경우 적절한 인터페이스 엔드포인트에 연결 string 을 사용하세요.

  • 클라우드 공급자 네트워크 내에서 실행되거나

  • 클라우드 공급자 네트워크에 전이적 네트워크 액세스가 가능합니다.

  • 최적화된 연결 문자열을 사용하려고 합니다.

이들 중 어느 것도 적용되지 않으면 IP 주소를 IP 액세스 목록에 추가하고 표준 연결 문자열을 사용하세요. 사무실이나 홈 네트워크에서 Atlas에 직접 연결하는 경우 이 옵션을 선호할 수 있습니다.

참고

구성된 PrivateLink 연결을 사용할 준비가 되어 있지 않으면 이 옵션을 선택할 수 없습니다. AWS PrivateLink 상태를 확인하려면 다음을 수행하세요.

Atlas에서 프로젝트의 Network Access 페이지로 이동합니다.

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

  2. 아직 표시되지 않은 경우 내비게이션 바의 Projects 메뉴에서 프로젝트를 선택합니다.

  3. 사이드바에서 Security 제목 아래의 Network Access를 클릭합니다.

    네트워크 액세스 페이지가 표시됩니다.

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 액세스 목록에 주소를 추가합니다.

Add a Connection IP Address

중요

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

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

IP 액세스 목록이 비어 있으면 Atlas는 프로젝트의 IP 액세스 목록에 IP 주소를 추가하라는 메시지를 표시합니다. Add a Different IP Address을 클릭하여 단일 IP 주소 또는 CIDR로 표기된 주소 범위를 추가합니다.

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

  1. Choose Connection Type에서 Private Endpoint을 선택합니다.

  2. Private Link Type 옵션이 표시되면 다음 옵션 중 하나를 선택합니다.

    • Optimized SRV Connection 로드 밸런싱된 연결의 경우.

    • Legacy SRV Connection 로드 밸런싱되지 않은 연결의 경우.

    자세한 내용은 비공개 엔드포인트 뒤의 샤딩된 클러스터에 대한 연결 성능 개선을 참조하세요.

  3. Choose Private Endpoint 아래에서 사용할 엔드포인트를 선택합니다.

5

중요

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

클러스터에 액세스하려면 프로젝트에 있는 클러스터에서 원하는 데이터베이스에 대한 액세스 권한이 있는 MongoDB 사용자가 필요합니다. 프로젝트에 MongoDB 사용자가 없는 경우 Atlas에서는 Atlas Admin 역할이 있는 새로운 사용자를 생성하라는 메시지가 표시됩니다.

  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>를 데이터베이스 사용자를 만들 때 지정한 비밀번호로 바꿉니다.

참고

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

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

다음 예시에서는 URI 연결 문자열을 사용하여 Atlas 클러스터를 인증하고 연결합니다. 예시의 자리 표시자를 자격 증명 및 배포 세부 정보로 바꿉니다.

참고

Atlas M0 무료 클러스터 또는 M2/M5 공유 클러스터에 연결하려면 MongoDB 4.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 버전
권장 드라이버 버전
모두
최신 권장 드라이버 버전은 MongoDB 호환성 매트릭스를 참조하십시오.
MongoDB 5.0 이상
버전 1.11 이상

참고

다음 구성 옵션은 단일 스레드 모드에서 C 드라이버를 실행하는 경우에만 적용됩니다.

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

  • serverSelectionTryOncefalse(으)로 설정하여 serverSelectionTimeoutMS에 정의된 시간 제한까지 서버 선택을 수행하도록 C 드라이버에 지시합니다.

  • 서버 선택 시간 제한을 기본값인 30000에서 15000으로 낮춥니다. MongoDB 투표는 일반적으로 10초가 걸리지만 Atlas에서는 5초만에 완료될 수 있습니다. 이 값을 15초(15000밀리초)로 설정하면 투표의 상한선과 지연 시간을 위한 추가 시간을 포함할 수 있습니다.

참고

Atlas M0 무료 클러스터 또는 M2/M5 공유 클러스터에 연결하려면 MongoDB 4.0 이상을 지원하는 C++ 드라이버 버전을 사용해야 합니다. C++ 드라이버와 MongoDB 간의 호환성에 관한 자세한 설명은 MongoDB 호환성 매트릭스를 참조하세요. 드라이버를 최신 버전으로 업그레이드하는 것을 권장합니다.

#include <mongocxx/client.hpp>
#include <mongocxx/instance.hpp>
//...
mongocxx::instance inst{};
mongocxx::client conn{mongocxx::uri{"mongodb+srv://<db_username>:<db_password>@<clusterName>.mongodb.net/?retryWrites=true&w=majority"}};
mongocxx::database db = conn["<databaseName>"];
MongoDB 버전
권장 드라이버 버전
모두
최신 권장 드라이버 버전은 MongoDB 호환성 매트릭스를 참조하십시오.

참고

레거시 C++ 드라이버는 수명이 종료되어 더 이상 지원되지 않습니다.

참고

다음 구성 옵션은 C++ 드라이버의 단일 스레드 mongocxx::client 클래스를 사용하여 Atlas 클러스터에 연결하는 경우에만 적용됩니다.

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

  • serverSelectionTryOncefalse로 설정하여 serverSelectionTimeoutMS에 정의된 시간 제한까지 서버 선택을 수행하도록 C++ 드라이버에 지시합니다.

  • 서버 선택 시간 제한을 기본값인 30000에서 15000으로 낮춥니다. MongoDB 투표는 일반적으로 10초가 걸리지만 Atlas에서는 5초만에 완료될 수 있습니다. 이 값을 15초(15000밀리초)로 설정하면 투표의 상한선과 지연 시간을 위한 추가 시간을 포함할 수 있습니다.

참고

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

var client = new MongoClient("mongodb+srv://<db_username>:<db_password>@<clusterName>.mongodb.net/?retryWrites=true&w=majority");
var database = client.GetDatabase("<databaseName>");
MongoDB 버전
권장 드라이버 버전
모두
최신 권장 드라이버 버전은 MongoDB 호환성 매트릭스를 참조하십시오.
MongoDB 5.0 이상
2.7 버전 이상

참고

Microsoft .NET Core 라이브러리 버전 2.1 이상 은 Linux 및 macOS에서 SNI TLS 확장을 지원 합니다. 이러한 플랫폼에서 이전 버전의 .NET Core를 사용하는 애플리케이션은 Atlas M0 무료 클러스터 또는 M2/M5 공유 클러스터 에 연결할 수 없습니다.

이 요구 사항에 관한 자세한 내용은 dotnet/corefx 문제를 참조하세요.

참고

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

uri := "mongodb+srv://<db_username>:<db_password>@<clusterName>.mongodb.net/?retryWrites=true&w=majority"
ctx, cancel := context.WithTimeout(context.Background(), 10*time.Second)
defer cancel()
client, err := mongo.Connect(ctx, options.Client().ApplyURI(uri))
if err != nil {
panic(err)
}
defer func() {
if err = client.Disconnect(ctx); err != nil {
panic(err)
}
}()
// Ping the primary
if err := client.Ping(ctx, readpref.Primary()); err != nil {
panic(err)
}
MongoDB 버전
권장 드라이버 버전
모두
최신 권장 드라이버 버전은 MongoDB 호환성 매트릭스를 참조하십시오.
MongoDB 5.0 이상
버전 1.0.0 이상

참고

Atlas M0 클러스터에 연결하려면 Java 버전 8 이상을 사용해야 하며 그리고 MongoDB 4.0 이상을 지원하는 Java 드라이버 버전을 사용해야 합니다, Java 드라이버와 MongoDB 간의 호환성에 대해 자세히 알아보려면 MongoDB 호환성 매트릭스를 참조하세요.

MongoClientURI uri = new MongoClientURI(
"mongodb+srv://<db_username>:<db_password>@<clusterName>.mongodb.net/?retryWrites=true&w=majority");
MongoClient mongoClient = MongoClients.create(uri);
MongoDatabase database = mongoClient.getDatabase("<databaseName>");
MongoDB 버전
권장 드라이버 버전
모두
최신 권장 드라이버 버전은 MongoDB 호환성 매트릭스를 참조하십시오.
MongoDB 5.0 이상
3.8 버전 이상

참고

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

val uri = "mongodb+srv://<db_username>:<db_password>@<clusterName>.mongodb.net/?retryWrites=true&w=majority"
// Construct a ServerApi instance using the ServerApi.builder() method
val serverApi = ServerApi.builder()
.version(ServerApiVersion.V1)
.build()
val settings = MongoClientSettings.builder()
.applyConnectionString(ConnectionString(uri))
.serverApi(serverApi)
.build()
// Create a new client and connect to the server
val mongoClient = MongoClient.create(settings)
val database = mongoClient.getDatabase("<databaseName>")
try {
// Send a ping to confirm a successful connection
val command = Document("ping", BsonInt64(1))
val commandResult = database.runCommand(command)
println("Pinged your deployment. You successfully connected to MongoDB!")
}
catch (me: MongoException) {
System.err.println(me)
}
MongoDB 버전
권장 드라이버 버전
MongoDB 5.0 이상
4.10 버전 이상

참고

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

import mongodb from 'mongodb';
const MongoClient = mongodb.MongoClient;
const uri = "mongodb+srv://<db_username>:<db_password>@<clusterName>.mongodb.net/?retryWrites=true&w=majority";
const client = new MongoClient(uri, { useNewUrlParser: true });
client.connect(err => {
const collection = client.db("<databaseName>").collection("<collectionName>");
// perform actions on the collection object
client.close();
});

admin 이외의 데이터베이스에 연결하지만 여전히 admin 데이터베이스에 인증하려면 연결 문자열의 database 구성 요소를 업데이트합니다.

mongodb://username:password@host1:port1,...,hostN:portN/database?authSource=admin&...

예시

다음 연결 문자열은 cluster0 배포 및 test 데이터베이스 구성 요소를 지정하고 authSource=admin 옵션을 포함합니다.

var uriTestDb = "mongodb+srv://<db_username>:<db_password>@cluster0.mongodb.net/test?ssl=true&authSource=admin&w=majority";
MongoClient.connect(uriTestDb, function(err, db) {
db.close();
});
MongoDB 버전
권장 드라이버 버전
모두
최신 권장 드라이버 버전은 MongoDB 호환성 매트릭스를 참조하십시오.
MongoDB 5.0 이상
버전 3.1 이상

참고

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

my $client = MongoDB->connect('mongodb+srv://<db_username>:<db_password>@<clusterName>.mongodb.net/?retryWrites=true&w=majority');
my $db = $client->get_database( '<databaseName>' );
MongoDB 버전
권장 드라이버 버전
MongoDB 4.2
MongoDB는 더 이상 Perl 드라이버를 유지 관리하지 않습니다. 최대 MongoDB 4.2까지 지원하는 드라이버 버전 2.2.2는 https://metacpan.org/pod/MongoDB에서 확인할 수 있습니다.

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

  • serverSelectionTryOncefalse로 설정하여 serverSelectionTimeoutMS에 정의된 시간 제한까지 서버 선택을 수행하도록 Perl 드라이버에 지시합니다.

  • 서버 선택 시간 제한을 기본값인 30000에서 15000으로 낮춥니다. MongoDB 투표는 일반적으로 10초가 걸리지만 Atlas에서는 5초만에 완료될 수 있습니다. 이 값을 15초(15000밀리초)로 설정하면 투표의 상한선과 지연 시간을 위한 추가 시간을 포함할 수 있습니다.

참고

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

다음 예제에서는 저수준 PHP 드라이버에 대한 고수준 추상화를 제공하는 MongoDB PHP 라이브러리를 사용합니다.

$client = new MongoDB\Client(
'mongodb+srv://<db_username>:<db_password>@<clusterName>.mongodb.net/?retryWrites=true&w=majority');
$db = $client-><databaseName>;
MongoDB 버전
권장 드라이버 버전
모두
최신 권장 드라이버 버전은 MongoDB 호환성 매트릭스를 참조하십시오.
MongoDB 5.0 이상
PHPLIB 1.4 + mongodb-1.5.

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

  • serverSelectionTryOncefalse로 설정하여 드라이버가 serverSelectionTimeoutMS로 정의된 시간 제한 내에서 서버 선택을 수행하도록 합니다.

  • 서버 선택 시간 제한을 기본값인 30000에서 15000으로 낮춥니다. MongoDB 투표는 일반적으로 10초가 걸리지만 Atlas에서는 5초만에 완료될 수 있습니다. 이 값을 15초(15000밀리초)로 설정하면 투표의 상한선과 지연 시간을 위한 추가 시간을 포함할 수 있습니다.

참고

Atlas M0 클러스터에 연결하려면 Python 2.7.9 이상을 사용해야 하며 그리고 MongoDB 4.0 이상을 지원하는 Python 드라이버 버전을 사용해야 합니다. Python 드라이버와 MongoDB 간의 호환성에 대해 자세히 알아보려면 MongoDB 호환성 매트릭스를 참조하세요.

import pymongo
import dns # required for connecting with SRV
client = pymongo.MongoClient("mongodb+srv://<db_username>:<db_password>@<clusterName>.mongodb.net/?retryWrites=true&w=majority")
db = client.<databaseName>
MongoDB 버전
권장 드라이버 버전
모두
최신 권장 드라이버 버전은 MongoDB 호환성 매트릭스를 참조하십시오.
MongoDB 5.0 이상
3.7 버전 이상

참고

macOS 및 Python 3.6 설치 관리자

https://www.python.org에서 macOS용 Python 3.6 설치 프로그램 CA 인증서를 자동으로 설치하지 않습니다. CA 인증서가 설치되지 않으면 Atlas에 대한 연결은 인증서 검증에 실패합니다.

https://www.python.org에서 설치 프로그램을 실행하여 Python 3.6을 설치한 후 Atlas에 연결하기 전에 다음 스크립트를 실행하여 최신 CA 번들을 설치해야 합니다.

open "/Applications/Python 3.6/Install Certificates.command"

macOS용 Python 3.6 설치 프로그램에 대한 자세한 내용은 https://www.python.org에서 확인할 수 있습니다. 관련 정보는 https://bugs.python.org/issue29065#msg283984에서 확인하세요. 이전 버전의 Python 및 다른 방법으로 설치된 Python 3.6 (예: Homebrew)은 영향을 받지 않습니다.

참고

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

client = Mongo::Client.new('mongodb+srv://<db_username>:<db_password>@<clusterName>.mongodb.net/?retryWrites=true&w=majority')

admin 이외의 데이터베이스에 연결하지만 여전히 admin 데이터베이스에 인증하려면 연결 문자열의 database 구성 요소를 업데이트합니다.

mongodb://username:password@host1:port1,...,hostN:portN/database?authSource=admin&...

예시

다음 연결 문자열은 cluster0 배포 및 test 데이터베이스 구성 요소를 지정하고 authSource=admin 옵션을 포함합니다.

client = Mongo::Client.new('mongodb+srv://<db_username>:<db_password>@cluster0.mongodb.net/test?ssl=true&replicaSet=Mycluster0-shard-0&authSource=admin&w=majority')
MongoDB 버전
권장 드라이버 버전
모두
최신 권장 드라이버 버전은 MongoDB 호환성 매트릭스를 참조하십시오.
MongoDB 5.0 이상
2.6 버전 이상
production:
# Configure available database clients. (required)
clients:
# Defines the default client. (required)
default:
# Defines the name of the default database that Mongoid can connect to.
# (required).
database: 'myDatabaseName'
# Provides the hosts the default client can connect to. Must be an array
# of host:port pairs. (required)
hosts:
- mycluster0-shard-00-00.mongodb.net:27017
- mycluster0-shard-00-01.mongodb.net:27017
- mycluster0-shard-00-02.mongodb.net:27017
options:
# The name of the user for authentication.
user: <username>
# The password of the user for authentication.
password: <password>
# The database or source to authenticate the user against. If the database
# specified above is not admin, admin MUST be specified here.
auth_source: admin
# All Atlas servers use SSL. (default: false)
ssl: true
MongoDB 버전
최소 ODM 버전
MongoDB 5.0 이상

드라이버에서 기본적으로 사용하는 비동기 런타임은 tokio입니다. 다른 런타임을 사용하려면 Configuring the async runtime(비동기 런타임 구성)을 참조하세요.

참고

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

use mongodb::{options::ClientOptions, Client};
#[tokio::main]
async fn main() -> mongodb::error::Result<()> {
let client_options = ClientOptions::parse(
"mongodb+srv://<db_username>:<db_password>@<clusterName>.mongodb.net/?retryWrites=true&w=majority",
)
.await?;
let client = Client::with_options(client_options)?;
let _database = client.database("<databaseName>");
// List the names of the databases in that cluster
for db_name in client.list_database_names(None, None)? {
println!("{}", db_name);
}
Ok(())
}
MongoDB 버전
권장 드라이버 버전
모두
최신 권장 드라이버 버전은 MongoDB 호환성 매트릭스를 참조하십시오.

동기화 API를 활성화했는지 확인합니다. 자세한 내용은 동기화 API 활성화를 참조하세요.

참고

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

use mongodb::{bson::doc, sync::Client};
fn main() -> mongodb::error::Result<()> {
let client_options = ClientOptions::parse(
"mongodb+srv://<db_username>:<db_password>@<clusterName>.mongodb.net/?retryWrites=true&w=majority",
)?;
// Ping the server to see if you can connect to the cluster
client
.database("admin")
.run_command(doc! {"ping": 1}, None)?;
println!("Connected successfully.");
// List the names of the databases in that cluster
for db_name in client.list_database_names(None, None)? {
println!("{}", db_name);
}
Ok(())
}
MongoDB 버전
권장 드라이버 버전
모두
최신 권장 드라이버 버전은 MongoDB 호환성 매트릭스를 참조하십시오.

참고

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

val uri: String = "mongodb+srv://<db_username>:<db_password>@<clusterName>.mongodb.net/?retryWrites=true&w=majority"
System.setProperty("org.mongodb.async.type", "netty")
val client: MongoClient = MongoClient(uri)
val db: MongoDatabase = client.getDatabase("<databaseName>")
MongoDB 버전
권장 드라이버 버전
모두
최신 권장 드라이버 버전은 MongoDB 호환성 매트릭스를 참조하십시오.

참고

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

import MongoSwift
import NIO
let elg = MultiThreadedEventLoopGroup(numberOfThreads: 4)
let uri = "mongodb+srv://<db_username>:<db_password>@<clusterName>.mongodb.net/?retryWrites=true&w=majority"
let client = try MongoClient(
uri,
using: elg
)
defer {
// clean up driver resources
try? client.syncClose()
cleanupMongoSwift()
// shut down EventLoopGroup
try? elg.syncShutdownGracefully()
}
// print a list of database names to confirm connection
print(try client.listDatabaseNames().wait())
MongoDB 버전
권장 드라이버 버전
모두
최신 권장 드라이버 버전은 MongoDB 호환성 매트릭스를 참조하십시오.

참고

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

import MongoSwiftSync
let uri = "mongodb+srv://<db_username>:<db_password>@<clusterName>.mongodb.net/?retryWrites=true&w=majority"
let client = try MongoClient(uri)
// print a list of database names to confirm connection
print (try client.listDatabaseNames())
MongoDB 버전
권장 드라이버 버전
모두
최신 권장 드라이버 버전은 MongoDB 호환성 매트릭스를 참조하십시오.

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

다음도 참조하세요.

돌아가기

연결 메서드