연결 문자열

➤ 오른쪽 상단의 언어 선택 드롭다운 메뉴를 사용하여 다음 예시의 언어를 설정합니다.

연결 문자열을 사용하여 MongoDB 인스턴스와 다음 대상 간의 연결을 정의할 수 있습니다.

호환성

연결 문자열을 사용하여 다음 환경에서 호스팅되는 배포에 연결할 수 있습니다.

MongoDB Atlas: 클라우드에서의 MongoDB 배포를 위한 완전 관리형 서비스

MongoDB Enterprise: MongoDB의 구독 기반 자체 관리 버전
MongoDB Community: MongoDB의 소스 사용 가능 무료 자체 관리 버전

연결 문자열 찾기

연결 문자열을 찾으려면 이 단계들을 완료하세요.

MongoDB Atlas 연결 문자열 찾기

MongoDB Atlas 연결 문자열은 다음 예제와 유사합니다.

자체 호스팅 배포서버의 연결 문자열 찾기

자체 호스팅 MongoDB Enterprise 또는 MongoDB Community 배포서버에 연결되어 있는 경우 db.getMongo() 메서드를 실행하여 해당 연결 문자열을 반환하세요.

배포서버에 연결되어 있지 않은 경우에는 사용하려는 연결 유형에 따라 연결 문자열을 정할 수 있습니다. SRV 연결 문자열 구문을 배우려면 SRV Connection Format(SRV 연결 형식)을, 표준 연결 문자열 구문을 배우려면 Standard Connection String Format(표준 연결 문자열 형식)을 참조하세요.

자체 호스팅 연결 문자열은 다음 예제와 유사합니다.

연결 문자열 옵션의 전체 목록은 SRV 연결 형식 또는 표준 연결 문자열 형식 을 참조하세요. 더 많은 예제는 연결 문자열 예제를 참조하세요.

연결 문자열 형식

다음 형식 중 하나를 사용하여 MongoDB 연결 문자열을 지정할 수 있습니다.

SRV 연결 형식: DNS SRV 레코드에 해당하는 호스트 이름이 포함된 연결 문자열입니다. 드라이버 또는 mongosh 가 레코드를 쿼리하여 mongod 또는 mongos 인스턴스를 실행 중인 호스트를 확인합니다.
표준 연결 문자열 형식: mongod 또는 mongos 인스턴스를 실행하는 모든 호스트를 지정하는 연결 문자열입니다.

MongoDB Atlas 데이터베이스 배포는 온라인 아카이브 에 연결하지 않는 한 SRV 연결 형식 을 사용합니다.

SRV 연결 형식

MongoDB는 DNS 구성형 시드 목록을 지원합니다. DNS를 사용하여 가용 서버 목록을 구성하면 배포서버의 유연성이 향상되고, 클라이언트를 재구성하지 않고도 서버를 교대로 변경할 수 있습니다.

SRV URI 연결 체계의 형식은 다음과 같습니다.

mongodb+srv://[username:password@]host[/[defaultauthdb][?options]]

더 많은 예제는 연결 문자열 예제를 참조하세요.

연결 문자열 구성 요소

연결 문자열에 포함되는 구성 요소는 다음과 같습니다.

구성 요소

설명

mongodb:// 또는 mongodb+srv://

표준 연결 형식(mongodb://) 또는 SRV 연결 형식(mongodb+srv://)의 문자열임을 식별하는 데 필요한 접두사입니다. 각 형식에 대해 자세히 알아보려면 표준 연결 문자열 형식 및 SRV 연결 형식을 참조하세요.

username:password@

선택 사항. 인증 자격 증명.

지정된 경우 클라이언트는 authSource 에 사용자 인증을 시도합니다. authSource 가 지정되지 않은 경우 클라이언트는 defaultauthdb 에 사용자 인증을 시도합니다. 그리고 defaultauthdb 가 지정되지 않은 경우 admin 데이터베이스로 이동합니다.

참고

사용자 이름 또는 비밀번호에 다음 문자가 포함된 경우:

$ : / ? # [ ] @

이러한 문자는 퍼센트 인코딩을 사용하여 변환해야 합니다.

authSource 도 참조하세요.

host[:port]

mongod 인스턴스(또는 샤드 클러스터의 경우 mongos 인스턴스)를 실행 중인 호스트(및 선택 가능한 포트 번호). 호스트 이름, IP 주소 또는 UNIX 도메인 소켓을 지정할 수 있습니다. 해당 배포서버 토폴로지에 적합한 수만큼 호스트를 지정하세요.

독립형의 경우 독립형 mongod 인스턴스의 호스트 이름을 지정하세요.
복제본 세트의 경우 복제본 세트 구성에 명시된 대로 mongod 인스턴스의 호스트 이름을 지정하세요.
샤드 클러스터의 경우 mongos 인스턴스의 호스트 이름을 지정하세요.

포트 번호를 지정하지 않으면 기본 포트 27017이(가) 사용됩니다.

참고

SRV URI 연결 형식을 사용하는 경우 호스트를 하나만 지정할 수 있고 포트는 지정할 수 없습니다. 그렇지 않으면 드라이버 또는 mongosh 에서 구문 분석 오류가 발생하고 DNS 확인을 수행하지 않습니다.

/defaultauthdb

선택 사항. 연결 문자열에 username:password@ 인증 자격 증명이 포함되어 있지만 authSource 옵션이 지정되지 않은 경우 사용할 인증 데이터베이스입니다.

authSource 및 defaultauthdb 가 모두 지정되지 않은 경우 클라이언트는 admin 데이터베이스에 대해 지정된 사용자 인증을 시도합니다.

?<options>

선택 사항. 연결별 옵션을 <name>=<value> 쌍으로 지정하는 쿼리 문자열입니다. 이러한 옵션에 대한 전체 설명은 연결 문자열 옵션 을 참조하세요.

이 연결 문자열이 데이터베이스를 지정하지 않는다면 마지막 host 및 옵션 문자열의 첫 문자인 물음표(?) 사이에 슬래시(/)를 지정해야 합니다.

DNS 시드 목록을 활용하려면 표준 mongodb 대신 접두사가 mongodb+srv 인 표준 연결 문자열 과 동일한 구문을 사용합니다. +srv 는 뒤에 오는 호스트 이름이 DNS SRV 레코드에 해당함을 클라이언트에 나타냅니다. 그러면 드라이버 또는 mongosh 가 레코드에 대해 DNS를 쿼리하여 mongod 또는 mongos 인스턴스를 실행 중인 호스트를 확인합니다.

참고

+srv 연결 문자열 수정자를 사용하면 연결에 대해 자동으로 tls (또는 이에 상응하는 ssl) 옵션이 true 로 설정됩니다. 쿼리 문자열의 tls=false (또는 ssl=false)을(를) 사용하여 tls (또는 이에 상응하는 ssl) 옵션을 false (으)로 명시적으로 설정하여 이 동작을 재정의할 수 있습니다.

+srv 형식을 사용하려면 hostname, domain 및 top-level domain (TLD)을(를) <hostname>.<domain>.<TLD>. 형식으로 지정해야 합니다. 이 표는 자리 표시자가 예제 값에 어떻게 상응하는지를 보여줍니다.

자리 표시자	예제
`<hostname>`	`server`
`<domain>`	`example`
`<TLD>`	`com`
`<hostname>.<domain>.<TLD>`	`server.example.com`

이 예제에서는 <hostname>.<domain>.<TLD> 형식을 올바르게 사용하는 DNS 시드 목록 연결 문자열을 보여줍니다. 이 문자열은 비밀번호 D1fficultP%40ssw0rd을(를) 사용하여 사용자 myDatabaseUser(으)로 인증합니다.

mongodb+srv://myDatabaseUser:D1fficultP%40ssw0rd@server.example.com/

해당 DNS 구성은 다음 내용과 유사합니다.

Record                            TTL   Class    Priority Weight Port  Target
_mongodb._tcp.server.example.com. 86400 IN SRV   0        5      27317 mongodb1.example.com.
_mongodb._tcp.server.example.com. 86400 IN SRV   0        5      27017 mongodb2.example.com.

개별 SRV 레코드는 _mongodb._tcp.<hostname>.<domain>.<TLD> 형식이어야 합니다.

클라이언트가 시드 목록의 멤버에 연결되는 경우, 이 클라이언트는 연결 대상이 될 수 있는 복제본 세트 멤버의 목록을 검색합니다. 클라이언트는 자체 시드 목록의 DNS 별칭을 사용하는 경우가 많습니다. 이는 호스트가 원본 시드 목록과 다른 서버 목록을 반환할 수 있다는 뜻입니다. 이런 상황이 발생할 경우, 클라이언트는 시드 목록에 나열된 호스트 이름 대신 복제본 세트에서 제공한 호스트 이름을 사용해서 결과 복제본 세트 구성의 호스트 이름을 통해 복제본 세트 멤버에 연결할 수 있게 합니다.

중요

SRV 레코드에서 반환된 호스트 이름은 그 상위 도메인(이 예제에서는 example.com)이 특정 호스트 이름과 동일해야 합니다. 상위 도메인과 호스트 이름이 일치하지 않으면 연결할 수 없습니다.

이 예제에서는 <hostname>이(가) 누락된 DNS 시드 목록 연결 문자열을 보여줍니다. 이는 정확하지 않으며 오류를 유발합니다.

# This connection string is missing the <hostname> and raises a connection error
mongodb+srv://myDatabaseUser:D1fficultP%40ssw0rd@example.com/

DNS 시드 목록 연결 문자열은 표준 연결 문자열과 마찬가지로 옵션을 쿼리 문자열로 지정할 수 있도록 지원합니다. DNS 시드 목록 연결 문자열을 사용하면 TXT 레코드를 통해 다음 옵션을 지정할 수도 있습니다.

replicaSet
authSource

사용자는 TXT 레코드를 mongod 인스턴스당 1개만 지정할 수 있습니다. DNS에 TXT 레코드가 여러 개 나타나거나 TXT 레코드에 replicaSet 또는 authSource 이외의 옵션이 포함되어 있으면 클라이언트가 오류를 반환합니다.

해당 server.example.com DNS 항목의 TXT 레코드는 다음 내용과 유사합니다.

Record              TTL   Class    Text
server.example.com. 86400 IN TXT   "replicaSet=mySet&authSource=authDB"

종합하면, DNS SRV 레코드와 TXT 레코드에 지정된 옵션은 다음과 같은 표준 형식 연결 문자열로 해석됩니다.

mongodb://myDatabaseUser:D1fficultP%40ssw0rd@mongodb1.example.com:27317,mongodb2.example.com:27017/?replicaSet=mySet&authSource=authDB

쿼리 문자열에 옵션을 전달하여 TXT 레코드에서 지정된 옵션을 재정의할 수 있습니다. 다음 예제에서 쿼리 문자열은 위 DNS 항목의 TXT 레코드에서 구성된 authSource 옵션에 대한 재정의를 제공했습니다.

mongodb+srv://myDatabaseUser:D1fficultP%40ssw0rd@server.example.com/?connectTimeoutMS=300000&authSource=aDifferentAuthDB

authSource에 대한 재정의가 제공되면 표준 형식의 해당 연결 문자열이 다음과 같은 상태가 됩니다.

mongodb://myDatabaseUser:D1fficultP%40ssw0rd@mongodb1.example.com:27317,mongodb2.example.com:27017/?connectTimeoutMS=300000&replicaSet=mySet&authSource=aDifferentAuthDB

참고

연결 문자열에서 식별된 호스트 이름에 해당하는 기록이 있는 사용 가능한 DNS가 없는 경우 mongodb+srv 옵션이 실패합니다. +srv 연결 문자열 수정자를 사용하는 경우 연결에 대해 tls (또는 이에 상응하는 ssl) 옵션이 true 로 설정됩니다. 쿼리 문자열의 tls=false (또는 ssl=false)을(를) 사용하여 tls (또는 이에 상응하는 ssl) 옵션을 false (으)로 명시적으로 설정하여 이 동작을 재정의할 수 있습니다.

DNS 시드 목록 연결 형식을 사용하여 mongosh 를 복제본 세트에 연결하는 예는 mongosh 연결 옵션을 참조하세요.

표준 연결 문자열 형식

이 섹션에서는 자체 호스팅된 MongoDB 독립 실행형 배포, 복제본 세트 또는 샤드 클러스터에 연결하는 데 사용되는 MongoDB 연결 URI의 표준 형식에 대해 설명합니다.

표준 URI 연결 체계의 형식은 다음과 같습니다.

mongodb://[username:password@]host1[:port1][,...hostN[:portN]][/[defaultauthdb][?options]]

더 많은 예제는 연결 문자열 예제를 참조하세요.

연결 문자열 구성 요소

연결 문자열에 포함되는 구성 요소는 다음과 같습니다.

구성 요소

설명

mongodb:// 또는 mongodb+srv://

username:password@

선택 사항. 인증 자격 증명.

참고

사용자 이름 또는 비밀번호에 다음 문자가 포함된 경우:

$ : / ? # [ ] @

이러한 문자는 퍼센트 인코딩을 사용하여 변환해야 합니다.

authSource 도 참조하세요.

host[:port]

독립형의 경우 독립형 mongod 인스턴스의 호스트 이름을 지정하세요.
복제본 세트의 경우 복제본 세트 구성에 명시된 대로 mongod 인스턴스의 호스트 이름을 지정하세요.
샤드 클러스터의 경우 mongos 인스턴스의 호스트 이름을 지정하세요.

포트 번호를 지정하지 않으면 기본 포트 27017이(가) 사용됩니다.

참고

/defaultauthdb

선택 사항. 연결 문자열에 username:password@ 인증 자격 증명이 포함되어 있지만 authSource 옵션이 지정되지 않은 경우 사용할 인증 데이터베이스입니다.

authSource 및 defaultauthdb 가 모두 지정되지 않은 경우 클라이언트는 admin 데이터베이스에 대해 지정된 사용자 인증을 시도합니다.

?<options>

선택 사항. 연결별 옵션을 <name>=<value> 쌍으로 지정하는 쿼리 문자열입니다. 이러한 옵션에 대한 전체 설명은 연결 문자열 옵션 을 참조하세요.

이 연결 문자열이 데이터베이스를 지정하지 않는다면 마지막 host 및 옵션 문자열의 첫 문자인 물음표(?) 사이에 슬래시(/)를 지정해야 합니다.

연결 문자열 옵션

이 섹션에는 SRV 연결 문자열과 표준 연결 문자열에 대한 모든 연결 옵션이 수록되어 있습니다.

연결 옵션은 name=value 형식의 쌍입니다.

name 옵션은 드라이버 사용 시 대소문자를 구분하지 않습니다.
name 옵션은 mongosh 를 사용할 때 대소문자를 구분하지 않습니다.
value은(는) 항상 대소문자를 구분합니다.

앰퍼샌드(&) 문자 name1=value1&name2=value2 로 옵션을 구분합니다. 다음 예제에서는 연결에 replicaSet 및 connectTimeoutMS 옵션이 포함되어 있습니다.

mongodb://myDatabaseUser:D1fficultP%40ssw0rd@db1.example.net:27017,db2.example.net:2500/?replicaSet=test&connectTimeoutMS=300000

참고

연결 문자열 인수용 세미콜론 구분자

드라이버는 이전 버전과 호환될 수 있도록 현재 세미콜론(;) 을 옵션 구분자로 사용하고 있습니다.

복제본 세트 옵션

다음 연결 문자열은 지정된 호스트에서 실행 중인 멤버가 있는 myRepl(이)라는 이름의 복제본 세트에 연결됩니다. 이 문자열은 비밀번호 D1fficultP%40ssw0rd을(를) 사용하여 사용자 myDatabaseUser(으)로 인증합니다.

mongodb://myDatabaseUser:D1fficultP%40ssw0rd@db0.example.com:27017,db1.example.com:27017,db2.example.com:27017/?replicaSet=myRepl

연결 옵션	설명
`replicaSet`	`mongod`이(가) 복제본 세트의 멤버인 경우 해당 복제본 세트의 이름을 지정합니다. 모든 드라이버 간에 일관적인 동작이 이뤄지게 하려면 `replicaSet` 연결 옵션을 설정하세요. 복제본 세트에 연결할 때 복제본 세트 멤버의 시드 목록 을 URI의 `host[:port]` 구성 요소에 제공합니다. 자세한 내용은 드라이버 설명서를 참조하세요.

연결 옵션

설명

replicaSet

mongod이(가) 복제본 세트의 멤버인 경우 해당 복제본 세트의 이름을 지정합니다. 모든 드라이버 간에 일관적인 동작이 이뤄지게 하려면 replicaSet 연결 옵션을 설정하세요.

복제본 세트에 연결할 때 복제본 세트 멤버의 시드 목록 을 URI의 host[:port] 구성 요소에 제공합니다. 자세한 내용은 드라이버 설명서를 참조하세요.

연결 옵션

TLS 옵션

복제본 세트에 대한 다음 연결 문자열에는 tls=true 옵션이 포함되어 있습니다. 비밀번호 D1fficultP%40ssw0rd 을(를) 사용하여 사용자 myDatabaseUser 으)로 인증합니다.

mongodb://myDatabaseUser:D1fficultP%40ssw0rd@db0.example.com,db1.example.com,db2.example.com/?replicaSet=myRepl&tls=true

또는 이에 상응하는 ssl=true 옵션을 사용할 수도 있습니다.

mongodb://myDatabaseUser:D1fficultP%40ssw0rd@db0.example.com,db1.example.com,db2.example.com/?replicaSet=myRepl&ssl=true

연결 옵션	설명
`tls`	연결을 위해 다음과 같이 TLS/SSL을 활성화하거나 비활성화합니다. `true`: TLS/SSL로 연결을 시작합니다. SRV 연결 형식의 기본값입니다. `false`: TLS/SSL 없이 연결을 시작합니다. 표준 연결 문자열 형식의 기본값입니다. 참고 `tls` 옵션은 `ssl` 옵션과 동일합니다. `mongosh` 셸이 명령줄에서 추가 tls/ssl 옵션을 지정하는 경우 `--tls` 명령줄 옵션을 대신 사용합니다.
`ssl`	연결에 대해 TLS/SSL을 활성화하거나 비활성화하는 부울: `true`: TLS/SSL로 연결을 시작합니다. SRV 연결 형식의 기본값입니다. `false`: TLS/SSL 없이 연결을 시작합니다. 표준 연결 문자열 형식의 기본값입니다. 참고 `ssl` 옵션은 `tls` 옵션과 동일합니다. `mongosh` 셸이 명령줄에서 추가 tls/ssl 옵션을 지정하는 경우 `--ssl` 명령줄 옵션을 대신 사용합니다.
`tlsCertificateKeyFile`	클라이언트의 TLS/SSL X.509 인증서 또는 클라이언트의 TLS/SSL 인증서 및 키가 담긴 로컬 `.pem` 파일의 위치를 지정합니다. 클라이언트가 이 파일을 `mongod`/`mongos` 인스턴스에 제공합니다. `mongod` / `mongos` 는 x가 표시되면 연결 시 경고를 기록합니다.509 인증서가 `mongod/mongos` 호스트 시스템 시간으로부터 `30` 일 이내에 만료됩니다. x를 참조하세요. 자세한 내용은 509 인증서 만료 임박 trigger 경고 를 참조하세요. 이 옵션은 모든 드라이버에서 지원되지 않습니다. 드라이버 설명서를 참조하세요. 이 연결 문자열 옵션은 `mongo` 셸에서는 사용할 수 없습니다. 대신 명령줄 옵션을 사용하세요.
`tlsCertificateKeyFilePassword`	`tlsCertificateKeyFile` 을 해독할 비밀번호를 지정합니다. 이 옵션은 모든 드라이버에서 지원되지 않습니다. 드라이버 설명서를 참조하세요. 이 연결 문자열 옵션은 `mongo` 셸에서는 사용할 수 없습니다. 대신 명령줄 옵션을 사용하세요.
`tlsCAFile`	인증 기관의 루트 인증서 체인이 들어 있는 로컬 `.pem` 파일의 위치를 지정합니다. 이 파일은 `mongod`/`mongos` 인스턴스에서 제공한 인증서의 유효성을 검사하는 데 사용됩니다. 이 옵션은 모든 드라이버에서 지원되지 않습니다. 드라이버 설명서를 참조하세요. 이 연결 문자열 옵션은 `mongo` 셸에서는 사용할 수 없습니다. 대신 명령줄 옵션을 사용하세요.
`tlsAllowInvalidCertificates`	`mongod`/`mongos` 인스턴스에서 제공하는 인증서의 유효성 검사를 우회합니다. 서버의 현재 인증서가 유효하지 않은 경우에도 MongoDB 인스턴스에 연결하려면 `true`(으)로 설정하세요. 이 옵션은 모든 드라이버에서 지원되지 않습니다. 드라이버 설명서를 참조하세요. 이 연결 문자열 옵션은 `mongo` 셸에서는 사용할 수 없습니다. 대신 명령줄 옵션을 사용하세요. 경고 인증서 유효성 검사를 비활성화하면 취약점이 생깁니다.
`tlsAllowInvalidHostnames`	`mongod`/`mongos` 인스턴스에서 제공하는 인증서의 호스트 이름 유효성 검사를 비활성화합니다. 서버 인증서의 호스트 이름이 서버의 호스트와 일치하지 않은 경우에도 MongoDB 인스턴스에 연결하려면 `true`(으)로 설정하세요. 이 옵션은 모든 드라이버에서 지원되지 않습니다. 드라이버 설명서를 참조하세요. 이 연결 문자열 옵션은 `mongo` 셸에서는 사용할 수 없습니다. 대신 명령줄 옵션을 사용하세요. 경고 인증서 유효성 검사를 비활성화하면 취약점이 생깁니다.
`tlsInsecure`	다양한 인증서 유효성 검사를 비활성화합니다. 인증서 유효성 검사를 비활성화하려면 `true` 로 설정합니다. 비활성화된 정확한 유효성 검사는 드라이버마다 다릅니다. 드라이버 설명서를 참조하세요. 이 연결 문자열 옵션은 `mongo` 셸에서는 사용할 수 없습니다. 대신 명령줄 옵션을 사용하세요. 경고 인증서 유효성 검사를 비활성화하면 취약점이 생깁니다.

타임아웃 옵션

연결 옵션	설명
`connectTimeoutMS`	시간이 초과되기 전에 연결을 시도하는 시간(밀리초)입니다. 기본값은 10 000 밀리초이지만 특정 드라이버의 기본값은 다를 수 있습니다. 자세한 내용은 드라이버 설명서를 참조하세요.
`socketTimeoutMS`	시도 시간이 초과되기 전에 소켓에서 전송 또는 수신을 시도하는 시간(밀리초)입니다. 기본값은 시간 초과가 절대 발생하지 않지만, 드라이버에 따라 다를 수 있습니다. 드라이버 설명서를 참조하세요.

압축 옵션

연결 옵션

설명

compressors

이 클라이언트와 mongod/mongos 인스턴스 간의 통신을 위해 네트워크 압축을 활성화하기 위한 압축기의 쉼표로 구분된 문자열입니다.

지정할 수 있는 압축기는 다음과 같습니다.

압축기를 여러 개 지정할 경우 통신 시작기는 물론 압축기를 나열하는 순서도 중요합니다. 그 예로 클라이언트가 다음 네트워크 압축기 "zlib,snappy"을(를) 지정하고 mongod이(가) "snappy,zlib"을(를) 지정하는 경우, 클라이언트와 mongod 간의 메시지에서는 zlib을(를) 사용합니다.

중요

양쪽 당사자가 네트워크 압축을 활성화하면 메시지가 압축됩니다. 그렇지 않으면 양 당사자 간의 메시지는 압축되지 않습니다.

양 당사자가 공통 압축기를 적어도 하나 이상 공유하지 않는 경우, 당사자 간의 메시지는 압축되지 않습니다.

mongosh 은(는) uri 연결 문자열 옵션 compressors 을(를) 지원합니다.

zlibCompressionLevel

network compression에 zlib를 사용하는 경우 압축 수준을 지정하는 정수입니다.

-1 ~ 9 범위에서 정수 값을 지정할 수 있습니다.

값	참고 사항
`-1`	기본 압축 레벨은 일반적으로 레벨 `6` 압축입니다.
`0`	압축 없음
`1` - `9`	압축 레벨이 높아지되 속도가 저하되면 다음과 같은 결과가 발생합니다. `1` 최고의 속도와 최소한의 압축이 제공됩니다. `9` 최상의 압축이 제공되지만 속도가 최저 수준으로 떨어집니다.

mongosh 에서 지원됩니다.

연결 풀 옵션

대부분의 드라이버는 일종의 연결 풀 처리를 구현합니다. 일부 드라이버는 연결 풀을 지원하지 않습니다. 연결 풀링 구현에 대한 자세한 내용은 드라이버 설명서를 참조하세요. 이러한 옵션을 사용하면 애플리케이션이 MongoDB deployment에 연결할 때 연결 풀을 구성할 수 있습니다.

연결 옵션	설명
`maxPoolSize`	연결 풀의 최대 연결 수입니다. 기본값은 `100`입니다.
`minPoolSize`	연결 풀의 최소 연결 수입니다. 기본값은 `0`입니다. 참고 `minPoolSize` 옵션은 일부 드라이버에서 지원되지 않습니다. 해당 드라이버에 대한 자세한 내용은 드라이버 설명서를 참조하세요.
`maxConnecting`	풀에서 동시에 설정할 수 있는 최대 연결 수입니다. 기본값은 `2`입니다. `maxConnecting` Rust 드라이버를 제외한 모든 드라이버에 대해 지원됩니다. `maxConnecting` 값을 높이면 클라이언트가 서버와의 연결을 더 빠르게 설정할 수 있지만 연결 폭풍이 발생할 가능성이 높아집니다. `maxConnecting` 값이 너무 낮으면 연결 풀에 심한 스로틀링이 발생하고 연결을 체크아웃하는 클라이언트의 테일 지연 시간이 증가할 수 있습니다.
`maxIdleTimeMS`	연결이 제거되거나 닫히기 전에 풀에서 유휴 상태로 유지될 수 있는 최대 시간(밀리초)입니다. 일부 드라이버에서는 이 옵션을 지원하지 않습니다.
`waitQueueMultiple`	풀에서 연결을 사용할 수 있을 때까지 대기할 수 있는 최대 스레드 수를 제공하기 위해 드라이버가 `maxPoolSize` 값을 곱하는 숫자입니다. 기본값은 드라이버 설명서를 참조하세요. 일부 드라이버에서는 이 옵션을 지원하지 않습니다.
`waitQueueTimeoutMS`	연결이 가능해질 때까지 스레드가 대기할 수 있는 최대 시간(밀리초)입니다. 기본값은 드라이버 설명서를 참조하세요. 일부 드라이버에서는 이 옵션을 지원하지 않습니다.

쓰기 고려 옵션

쓰기 고려에서는 MongoDB에서 요청한 승인의 수준을 설명합니다. 쓰기 고려 옵션은 다음 드라이버에서 지원됩니다.

연결 문자열에서, 그리고 insert 또는 update 등의 메서드에 대한 매개변수로서 쓰기 고려를 지정할 수 있습니다. 쓰기 고려가 두 위치 양쪽에 지정되면 해당 메서드 매개변수가 연결 문자열 설정을 재정의합니다.

MongoDB Atlas 배포서버 연결 문자열은 기본적으로 "majority"을(를) 사용합니다. MongoDB Atlas 배포서버에 대해 쓰기 고려를 지정하지 않으면 MongoDB Atlas가 "majority"을(를) 실행합니다.

복제본 세트에 대한 다음 연결 "majority" 문자열은 쓰기 5 고려 매개변수를 사용하여 쓰기 wtimeoutMS 고려 및 초 시간 제한을 지정합니다.

mongodb://myDatabaseUser:D1fficultP%40ssw0rd@db0.example.com,db1.example.com,db2.example.com/?replicaSet=myRepl&w=majority&wtimeoutMS=5000

연결 옵션	설명
`w`	쓰기 고려 `w` 옵션에 해당합니다. `w` 옵션은 쓰기 작업이 지정된 개수의 `mongod` 인스턴스 또는 태그가 지정된 `mongod` 인스턴스로 전파되었음을 확인하도록 요청합니다. 사용자는 `number`, 문자열 `majority` 또는 `tag set`을(를) 지정할 수 있습니다. 자세한 내용은 `w` 옵션을 참조하세요.
`wtimeoutMS`	쓰기 고려 `wtimeout` 에 해당합니다. `wtimeoutMS` 는 쓰기 고려에 대한 시간 제한(밀리초)을 지정합니다. `wtimeoutMS`이(가) `0`인 경우에는 쓰기 작업의 시간이 절대 초과되지 않습니다. 자세한 내용은 `wtimeout`을(를) 참조하세요.
`journal`	쓰기 고려 `j` 옵션 옵션에 해당합니다. `journal` 옵션은 MongoDB에 쓰기 작업이 저널 에 기록되었음을 확인 요청합니다. 자세한 내용은 `j` 옵션을 참조하세요. `journal` 을(를) `true` 로 설정하고 `w` 값을 1 미만으로 지정하면 `journal` 이 우선합니다.

자세한 내용은 쓰기 고려를 참조하세요.

`readConcern` 옵션

WiredTiger 스토리지 엔진의 경우, MongoDB 3.2는 복제본 세트 및 복제본 세트 샤드에 readConcern 옵션을 도입합니다.

Read Concern(읽기 고려)을 사용하면 클라이언트가 복제본 세트에서 본인의 읽기에 대한 격리 레벨을 선택할 수 있습니다.

복제본 세트에 대한 다음 연결 문자열은 readConcernLevel=majority 을(를) 지정합니다.

mongodb://myDatabaseUser:D1fficultP%40ssw0rd@db0.example.com,db1.example.com,db2.example.com/?replicaSet=myRepl&readConcernLevel=majority

연결 옵션	설명
`readConcernLevel`	격리 레벨입니다. 다음 값 중 하나를 허용할 수 있습니다. `local` `majority` `linearizable` `available` 이 연결 문자열 옵션은 `mongosh` 에는 사용할 수 없습니다. 특정 작업에 대한 옵션으로 읽기 고려를 지정합니다.

자세한 내용은 Read Concern을 참조하십시오.

읽기 기본 설정 옵션

읽기 기본 설정에서는 복제본 세트와 관련 있는 읽기 작업의 동작을 설명합니다. 이 매개변수를 사용하면 연결 문자열의 각 연결에 읽기 기본 설정을 지정할 수 있습니다.

참고

드라이버를 사용하여 헤지된 읽기(hedged read) 옵션을 지정하려면 드라이버의 읽기 설정 API를 참조하세요.

예를 들면 다음과 같습니다.

복제본 세트에 대한 다음 연결 문자열은 secondary 읽기 설정 모드와 120 초의 maxStalenessSeconds 값을 지정합니다.

mongodb://myDatabaseUser:D1fficultP%40ssw0rd@db0.example.com,db1.example.com,db2.example.com/?replicaSet=myRepl&readPreference=secondary&maxStalenessSeconds=120

샤드 클러스터에 대한 다음 연결 문자열은 secondary 읽기 설정 모드와 120 초의 maxStalenessSeconds 값을 지정합니다.
```
mongodb://myDatabaseUser:D1fficultP%40ssw0rd@mongos1.example.com,mongos2.example.com/?readPreference=secondary&maxStalenessSeconds=120
```

샤드 클러스터에 대한 다음 연결 문자열은 secondary 읽기 설정 모드와 세 개의 readPreferenceTags 을(를) 지정합니다.

mongodb://myDatabaseUser:D1fficultP%40ssw0rd@mongos1.example.com,mongos2.example.com/?readPreference=secondary&readPreferenceTags=dc:ny,rack:r1&readPreferenceTags=dc:ny&readPreferenceTags=

readPreferenceTags를 여러 개 사용할 때는 순서가 중요합니다. 일치하는 항목이 발견될 때까지 readPreferenceTags가 순서대로 시도됩니다. 일단 검색되면 해당 사양이 일치하는 모든 적합한 멤버를 찾는 데 사용되며 나머지 readPreferenceTags는 무시됩니다. 자세한 내용은 태그 일치 순서를 참조하세요.

연결 옵션	설명
`readPreference`	이 연결에 대한 읽기 기본 설정을 지정합니다. 가능한 값은 다음과 같습니다. `primary`(Default(기본값)) `primaryPreferred` `secondary` `secondaryPreferred` `nearest` 분산 트랜잭션 에 포함된 읽기 작업은 `primary`로 읽기 설정을 사용해야 합니다. 특정 트랜잭션의 모든 작업은 동일한 노드로 라우팅되어야 합니다. 이 연결 문자열 옵션은 `mongo` 셸에 사용할 수 없습니다. 대신 `cursor.readPref()` 및 `Mongo.setReadPref()`을(를) 참조하세요.
`maxStalenessSeconds`	클라이언트가 읽기 작업에 대한 세컨더리 사용을 중단하기 전에 세컨더리가 지속될 수 있는 시간(단위: 초)을 지정합니다. 자세한 내용은 읽기 기본 설정 `maxStalenessSeconds`을(를) 참조하세요. 기본적으로 최대 부실도는 없으며 클라이언트는 읽기 작업을 지시할 위치를 선택할 때 보조 서버의 지연을 고려하지 않습니다. 최소 `maxStalenessSeconds` 값은 90 초입니다. 0 ~ 90 초 사이의 값을 지정하면 오류가 발생합니다. MongoDB 드라이버는 `maxStalenessSeconds` 값 `-1` 를 `maxStalenessSeconds` 가 생략된 경우와 동일하게 "최대 비활성 없음"으로 처리합니다. 중요 `maxStalenessSeconds`을(를) 사용하려면 해당 배포서버의 모든 MongoDB 인스턴스가 MongoDB 3.4 이상을 사용 중이어야 합니다. 어떤 것이든 인스턴스가 이전 버전의 MongoDB를 사용 중이면 드라이버 또는 `mongod`/`mongos`에서 오류가 발생합니다.
`readPreferenceTags`	태그 문서를 콜론으로 구분된 키-값 쌍의 쉼표로 구분된 목록으로 지정합니다. 예: 태그 문서 `{ "dc": "ny", "rack": "r1" }`을(를) 지정하려면 연결 문자열에 `readPreferenceTags=dc:ny,rack:r1`을(를) 사용하세요. 빈 태그 문서 `{ }`을(를) 지정하려면 값을 설정하지 않은 상태에서 `readPreferenceTags=`을(를) 사용하세요. 태그 문서 목록을 지정하려면 `readPreferenceTags`을(를) 여러 개 사용하세요. 예: `readPreferenceTags=dc:ny,rack:r1&readPreferenceTags=` `readPreferenceTags`를 여러 개 사용할 때는 순서가 중요합니다. 일치하는 항목이 발견될 때까지 `readPreferenceTags`가 순서대로 시도됩니다. 자세한 내용은 태그 일치 순서를 참조하세요. 이 연결 문자열 옵션은 `mongo` 셸에 사용할 수 없습니다. 대신 `cursor.readPref()` 및 `Mongo.setReadPref()`을(를) 참조하세요.

자세한 내용은 읽기 설정을 참조하세요.

인증 옵션

복제본 세트에 대한 다음 연결 문자열은 admin 데이터베이스에 대한 authSource 을(를) 지정합니다. 즉, 사용자 자격 증명이 admin 데이터베이스에 대해 인증됩니다.

mongodb://myDatabaseUser:D1fficultP%40ssw0rd@mongodb0.example.com:27017,mongodb1.example.com:27017,mongodb2.example.com:27017/?replicaSet=myRepl&authSource=admin

참고

사용자 이름 또는 비밀번호에 다음 문자가 포함된 경우:

$ : / ? # [ ] @

이러한 문자는 퍼센트 인코딩을 사용하여 변환해야 합니다.

연결 옵션

설명

authSource

사용자의 자격 증명과 연결된 데이터베이스 이름을 지정합니다. authSource 이(가) 지정되지 않은 경우 authSource 은(는) 연결 문자열에 지정된 defaultauthdb 으)로 기본 설정됩니다. defaultauthdb 가 지정되지 않은 경우 authSource 기본값은 admin 입니다.

PLAIN (LDAP), GSSAPI (Kerberos) 및 MONGODB-AWS (IAM) 인증 메커니즘에서는 자격 증명 저장소를 외부 서비스에 위임하므로 authSource 을 $external 로 설정해야 합니다.

연결 문자열에서 또는 --username 매개변수를 통해 사용자 이름을 제공하지 않으면 MongoDB는 authSource 값을 무시합니다.

authMechanism

기본값: SCRAM-SHA-256

MongoDB가 연결 인증에 사용하는 인증 메커니즘을 지정하세요. authMechanism을(를) 지정하지 않되 사용자 자격 증명을 제공하면 MongoDB가 SCRAM-SHA-256 사용을 시도합니다. 이 작업이 실패하면 SCRAM-SHA-1로 돌아갑니다.

SCRAM-SHA-1
SCRAM-SHA-256
MONGODB-X509
MONGODB-AWS
GSSAPI(Kerberos)
PLAIN (LDAP SASL)

MongoDB Enterprise mongod 인스턴스 및 mongos 인스턴스만이 GSSAPI(Kerberos) 메커니즘 및 PLAIN(LDAP) 메커니즘을 제공합니다.

MONGODB-X509을(를) 사용하려면 TLS/SSL이 활성화되어 있어야 합니다.

을(를) 사용하려면 MONGODB-AWS AWS IAM 자격 증명 을 통해 인증을 지원하도록 구성된 MongoDB Atlas 클러스터에 연결해야 합니다. (AWS 액세스 키 ID 및 보안 액세스 키, 그리고 선택적으로 AWS 세션 토큰 ). MONGODB-AWS 인증 메커니즘에서는 로 설정해야 authSource $external합니다.

사용하는 MONGODB-AWS 경우 AWS 액세스 키 ID를 사용자 이름으로, 보안 액세스 키를 비밀번호로 입력합니다.AWS 세션 토큰 을 사용하는 경우 AWS_SESSION_TOKEN authMechanismProperties 값도 함께 제공하세요.

참고

AWS 액세스 키 ID, 보안 액세스 키 또는 세션 토큰에 다음 문자가 포함되어 있는 경우

$ : / ? # [ ] @

이러한 문자는 퍼센트 인코딩을 사용하여 변환해야 합니다.

또는 AWS 액세스 키 ID, 보안 액세스 키 또는 세션 토큰이 해당 AWS IAM 환경 변수 를 mongosh 사용하여 플랫폼에서 정의된 경우 는 이러한 환경 변수 값을 사용하여 인증합니다. 연결 문자열에 지정할 필요가 없습니다.

연결 문자열과 환경 변수 메서드를 모두 사용하는 MONGODB-AWS 인증 메커니즘의 사용 예시 는 Atlas 클러스터에 연결을 참조하세요.

MongoDB의 인증 시스템에 대한 자세한 내용은 Authentication(인증)을 참조하세요. x509 인증에 대한 자세한 내용은 Use x.509 Certificates to Authenticate Clients(x.509 인증서로 클라이언트 인증하기)도 같이 참조하세요.

authMechanismProperties

지정된 authMechanism 의 속성을 콜론으로 구분된 키-값 쌍의 쉼표로 구분된 목록으로 지정합니다.

가능한 키-값 쌍은 다음과 같습니다.

SERVICE_NAME:<string>

Kerberized MongoDB 인스턴스에 연결할 경우 Kerberos 서비스 이름을 설정하세요. 이 값은 연결하려는 MongoDB 인스턴스에 설정된 서비스 이름과 일치해야 합니다. GSSAPI 인증 메커니즘을 사용할 때만 유효합니다.

SERVICE_NAME 모든 클라이언트 및 MongoDB 인스턴스에 대해 mongodb(으)로 기본 설정됩니다. MongoDB 인스턴스에서 saslServiceName 설정을 변경한다면 해당 설정과 일치하도록 SERVICE_NAME을(를) 설정해야 합니다. GSSAPI 인증 메커니즘을 사용할 때만 유효합니다.

CANONICALIZE_HOST_NAME:true|false

Kerberos 서버에 연결할 경우 클라이언트 호스트 머신의 호스트 이름을 표준화하세요. 이 작업은 호스트가 Kerberos 데이터베이스에 있는 것과 다른 호스트 이름을 보고하는 경우 필요할 수 있습니다. false(으)로 기본 설정됩니다. GSSAPI 인증 메커니즘을 사용할 때만 유효합니다.

SERVICE_REALM:<string>

MongoDB 서비스에 필요한 Kerberos 영역을 설정하세요. 이 작업은 사용자가 한 영역에 있고 서비스가 다른 영역에 있는 교차 영역 인증을 지원하는 데 필요할 수 있습니다. GSSAPI 인증 메커니즘을 사용할 때만 유효합니다.

AWS_SESSION_TOKEN:<security_token>

AssumeRole 을 사용할 때 임시 자격 증명으로 인증을 위한 AWS 세션 토큰을 설정합니다. 요청하거나 Lambda와 같이 이 값을 지정하는 AWS 리소스로 작업할 때 사용할 수 MONGODB-AWS 있습니다. 인증 메커니즘을 사용할 때만 유효합니다. AWS 액세스 키 ID와 보안 액세스 키도 있어야 합니다. 사용 예시 는 Atlas 클러스터에 연결을 참조하세요.

gssapiServiceName

Kerberized MongoDB 인스턴스에 연결할 때 Kerberos 서비스 이름을 설정합니다. 이 값은 연결하려는 MongoDB 인스턴스에 설정된 서비스 이름과 일치해야 합니다.

모든 클라이언트 및 MongoDB 인스턴스에 대해 gssapiServiceName 의 기본값은 mongodb 입니다. MongoDB 인스턴스에서 saslServiceName 설정을 변경하는 경우 해당 설정과 일치하도록 gssapiServiceName 를 설정해야 합니다.

gssapiServiceName 은 authMechanismProperties=SERVICE_NAME:mongodb 에 대해 더 이상 사용되지 않는 별칭입니다. 드라이버가 지원하는 옵션과 각 옵션의 상대적 우선 순위에 대한 자세한 내용은 선호하는 드라이버 버전의 설명서를 참조하세요.

서버 선택/검색 옵션

MongoDB는 MongoDB 드라이버 및 mongos 인스턴스가 읽기 또는 쓰기 작업의 대상으로 지시할 서버를 선택하는 방법을 구성할 수 있도록 다음 옵션을 제공합니다.

연결 옵션	설명
`localThresholdMS`	여러 개의 적합한 MongoDB 인스턴스 중에서 선택하기 위한 지연 시간 창의 크기(단위: 밀리초)입니다. Default(기본값): 15밀리초. 모든 드라이버는 `localThresholdMS` 을(를) 사용합니다. 지연 시간 창 크기를 `mongos`로 지정할 때는 `localThreshold` 별칭을 사용합니다.
`serverSelectionTimeoutMS`	예외가 발생하기 전에 서버 선택을 차단할 때까지 걸리는 시간(단위: 밀리초)을 지정합니다. Default(기본값): 30,000밀리초.
`serverSelectionTryOnce`	단일 스레드 드라이버만 해당. `true` 인 경우, 서버 선택이 실패한 후 드라이버가 MongoDB deployment를 정확히 한 번 스캔한 다음 서버를 선택하거나 오류를 제기하도록 지시합니다. `false` 인 경우 드라이버는 최대 `serverSelectionTimeoutMS` 값까지 서버를 차단하고 검색합니다. 기본값: `true`. 멀티스레드 드라이버와 `mongos` 는 `serverSelectionTryOnce` 을(를) 지원하지 않습니다.
`heartbeatFrequencyMS`	`heartbeatFrequencyMS` 은(는) 드라이버가 MongoDB 배포 상태를 확인하는 시기를 제어합니다. 이전 검사가 끝난 후부터 다음 검사가 시작될 때까지 검사 간격(밀리초)을 지정합니다. 기본값: 단일 스레드 드라이버: 60초. 다중 스레드 드라이버: 10초. `mongos` 은(는) 심장 박동 확인 빈도 변경을 지원하지 않습니다.

기타 구성

연결 옵션	설명
`appName`	사용자 지정 앱 이름을 지정하세요. 앱 이름이 다음 란에 표시됩니다. `mongod` 로그 및 `mongos` 로그 `currentOp` 명령 및 `db.currentOp()` 메서드 출력의 `currentOp.appName` 필드 데이터베이스 프로파일러 출력의 `system.profile.appName` 필드 `appName` 연결 옵션은 다음에 사용할 수 있습니다. MongoDB 4 에서 시작되는 MongoDB 드라이버 .0 `mongosh` 에서 시작하는 `mongosh` 1 }1. .9 Compass 1 에서 시작되는 MongoDB Compass .28.4
`retryReads`	재시도 가능 읽기를 활성화합니다. 가능한 값은 다음과 같습니다. `true`. 연결에 대해 재시도 가능 읽기를 활성화합니다. 공식 MongoDB 드라이버의 기본값은 `true` 입니다. `false`. 연결에 대해 재시도 가능 읽기를 비활성화합니다. `mongosh` 재시도 가능 읽기를 지원하지 않습니다.
`retryWrites`	재시도 가능 쓰기를 활성화합니다. 가능한 값은 다음과 같습니다. `true`. 연결에 대해 재시도 가능 쓰기를 활성화합니다. 공식 MongoDB 드라이버의 기본값은 `true` 입니다. `false`. 연결에 대해 재시도 가능 쓰기를 비활성화합니다. 공식 MongoDB 4.0 및 3.6 호환 드라이버는 `false`(으)로 기본 설정됩니다. MongoDB 드라이버는 값에 관계없이 트랜잭션 커밋 `retryWrites` 및 중단 작업을 재시도합니다. 트랜잭션 재시도 가능성에 대한 자세한 내용은 트랜잭션 오류 처리를 참조하세요.
`uuidRepresentation`	가능한 값은 다음과 같습니다. `standard` 표준 바이너리 표현입니다. `csharpLegacy` C# 드라이버의 기본 표현입니다. `javaLegacy` Java 드라이버의 기본 표현입니다. `pythonLegacy` Python 드라이버의 기본 표현입니다. 기본값은 해당 드라이버의 드라이버 설명서를 참조하세요. 참고 모든 드라이버가 `uuidRepresentation` 옵션을 지원하는 것은 아닙니다. 드라이버에 대한 자세한 내용은 드라이버 설명서를 참조하세요.

연결 문자열 예제

다음 항목은 일반 연결 대상에 대한 예시 URI 문자열을 제공합니다.

MongoDB Atlas 배포서버 연결 문자열 예제

다음 예제 연결 문자열은 MongoDB Atlas 배포에 연결합니다.

사용자 이름 및 비밀번호로 인증되는 MongoDB Atlas 클러스터

AWS IAM 자격 증명으로 인증되는 MongoDB Atlas 클러스터

다음은 AWS IAM 자격 증명 을 통해 인증을 지원하도록 구성된 MongoDB Atlas 클러스터에 연결됩니다.

이러한 방식으로 AWS IAM 자격 증명을 사용하여 Atlas에 연결하면 이 예제와 같이 MONGODB-AWS authentication mechanism 및 $external authSource 가 사용됩니다.

AWS 세션 토큰 을 사용하는 경우 AWS_SESSION_TOKEN authMechanismProperties 값도 다음과 같이 제공합니다.

참고

AWS 액세스 키 ID, 보안 액세스 키 또는 세션 토큰에 다음 문자가 포함되어 있는 경우

$ : / ? # [ ] @

이러한 문자는 퍼센트 인코딩을 사용하여 변환해야 합니다.

표준 AWS IAM 환경 변수 를 사용하여 플랫폼에서 이러한 자격 증명을 설정할 수도 있습니다. . mongosh 는 를 사용할 때 다음 환경 변수를 MONGODB-AWS authentication mechanism 확인합니다.

AWS_ACCESS_KEY_ID
AWS_SECRET_ACCESS_KEY
AWS_SESSION_TOKEN

설정된 경우 이러한 자격 증명을 연결 문자열에 지정할 필요가 없습니다.

다음 예시에서는 bash 셸에서 이러한 환경 변수를 설정합니다.

export AWS_ACCESS_KEY_ID='<aws access key id>'
export AWS_SECRET_ACCESS_KEY='<aws secret access key>'
export AWS_SESSION_TOKEN='<aws session token>'

다른 셸에서 환경 변수를 설정하는 구문은 다를 수 있습니다. 자세한 내용은 사용 중인 플랫폼의 설명서를 참조하세요.

다음 명령어로 이러한 환경 변수가 설정되었는지 확인할 수 있습니다.

env | grep AWS

설정이 완료되면 다음 예제에서는 이러한 환경 변수를 사용하여 MongoDB Atlas 클러스터에 연결합니다.

자체 호스팅 배포서버 연결 문자열 예제

다음 예제 연결 문자열은 자체 호스팅 배포에 연결합니다.

사용자 이름 및 비밀번호로 인증되는 자체 호스팅 클러스터

로컬로 실행되는 자체 호스팅 데이터베이스 서버

다음은 기본 포트에서 로컬로 실행되는 데이터베이스 서버에 연결합니다.

로컬로 실행되는 자체 호스팅 `admin` 데이터베이스

다음 항목은 비밀번호가 D1fficultP%40ssw0rd인 사용자 myDatabaseUser(으)로서 admin 데이터베이스에 연결되고 로그인합니다.

로컬로 실행되는 자체 호스팅 `records` 데이터베이스

다음 항목은 비밀번호가 D1fficultP%40ssw0rd인 사용자 myDatabaseUser(으)로서 records 데이터베이스에 연결되고 로그인합니다.

자체 호스팅 UNIX 도메인 소켓

UNIX 도메인 소켓에 연결할 때는 URL로 인코딩된 연결 문자열을 사용합니다.

다음 항목은 비밀번호가 D1fficultP%40ssw0rd인 사용자 myDatabaseUser(으)로서 파일 경로가 /tmp/mongodb-27017.sock인 UNIX 도메인 소켓에 연결됩니다.

참고

모든 드라이버가 UNIX 도메인 소켓을 지원하는 것은 아닙니다. 해당 드라이버에 대한 자세한 내용은 드라이버 설명서를 참조하세요.

다른 머신에 멤버가 있는 자체 호스팅 복제본 세트

다음 항목은 비밀번호가 D1fficultP%40ssw0rd인 사용자 myDatabaseUser(으)로서 멤버가 2개인(1개는 db1.example.net에, 다른 1개는 db2.example.net에 있음) 복제본 세트에 연결됩니다.

참고

복제본 세트의 경우 복제본 세트 구성에 명시된 대로 mongod 인스턴스의 호스트 이름을 지정하세요.

다음 경로에 멤버가 있는 자체 호스팅 복제본 세트: `localhost`

다음 항목은 비밀번호가 D1fficultP%40ssw0rd인 사용자 myDatabaseUser(으)로서 세 멤버가 포트 27017, 27018, 27019의 localhost에서 실행 중인 복제본 세트에 연결됩니다.

참고

복제본 세트의 경우 복제본 세트 구성에 명시된 대로 mongod 인스턴스의 호스트 이름을 지정하세요.

읽기 배포 기능이 포함된 자체 호스팅 복제본 세트

다음 항목은 비밀번호가 D1fficultP%40ssw0rd인 사용자 myDatabaseUser(으)로서 세컨더리에 대한 멤버 및 배포가 3개인 복제본 세트에 연결됩니다.

참고

복제본 세트의 경우 복제본 세트 구성에 명시된 대로 mongod 인스턴스의 호스트 이름을 지정하세요.

상위 레벨의 쓰기 고려가 있는 자체 호스팅 복제본 세트

다음 항목은 데이터 보유 투표 멤버 중 대다수가 제한 시간이 2초인 상태에서 복제에 성공할 때까지 대기하도록 쓰기 고려가 구성된 복제본 세트에 연결됩니다. 이 항목은 비밀번호가 D1fficultP%40ssw0rd인 사용자 myDatabaseUser(으)로 인증됩니다.

참고

복제본 세트의 경우 복제본 세트 구성에 명시된 대로 mongod 인스턴스의 호스트 이름을 지정하세요.

자체 호스팅 샤드 클러스터

다음 항목은 비밀번호가 D1fficultP%40ssw0rd인 사용자 myDatabaseUser(으)로서 mongos 인스턴스가 3개인 샤드 클러스터에 연결됩니다.

← 구성 파일 설정 및 명령줄 옵션 매핑

데이터베이스 명령 →

연결 문자열.css-134mg1q{-webkit-align-self:center;-ms-flex-item-align:center;align-self:center;padding:0 10px;visibility:hidden;}.css-6vrlzm{border-radius:0!important;display:initial!important;margin:initial!important;}.css-1l4s55v{margin-top:-175px;position:absolute;padding-bottom:2px;}

호환성

연결 문자열 찾기

MongoDB Atlas 연결 문자열 찾기

자체 호스팅 배포서버의 연결 문자열 찾기

연결 문자열 형식

SRV 연결 형식

연결 문자열 구성 요소

참고

참고

참고

중요

참고

표준 연결 문자열 형식

연결 문자열 구성 요소

참고

참고

연결 문자열 옵션

참고

연결 문자열 인수용 세미콜론 구분자

복제본 세트 옵션

연결 옵션

TLS 옵션

참고

참고

경고

경고

경고

타임아웃 옵션

압축 옵션

중요

연결 풀 옵션

참고

쓰기 고려 옵션

readConcern 옵션

읽기 기본 설정 옵션

참고

중요

인증 옵션

참고

참고

서버 선택/검색 옵션

기타 구성

참고

연결 문자열 예제

MongoDB Atlas 배포서버 연결 문자열 예제

사용자 이름 및 비밀번호로 인증되는 MongoDB Atlas 클러스터

AWS IAM 자격 증명으로 인증되는 MongoDB Atlas 클러스터

참고

자체 호스팅 배포서버 연결 문자열 예제

사용자 이름 및 비밀번호로 인증되는 자체 호스팅 클러스터

로컬로 실행되는 자체 호스팅 데이터베이스 서버

로컬로 실행되는 자체 호스팅 admin 데이터베이스

로컬로 실행되는 자체 호스팅 records 데이터베이스

자체 호스팅 UNIX 도메인 소켓

참고

다른 머신에 멤버가 있는 자체 호스팅 복제본 세트

참고

다음 경로에 멤버가 있는 자체 호스팅 복제본 세트: localhost

참고

읽기 배포 기능이 포함된 자체 호스팅 복제본 세트

참고

상위 레벨의 쓰기 고려가 있는 자체 호스팅 복제본 세트

참고

자체 호스팅 샤드 클러스터

연결 문자열

`readConcern` 옵션

로컬로 실행되는 자체 호스팅 `admin` 데이터베이스

로컬로 실행되는 자체 호스팅 `records` 데이터베이스

다음 경로에 멤버가 있는 자체 호스팅 복제본 세트: `localhost`