연결 문자열 옵션

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

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

클라이언트가 연결 URI의 host[:port]에 직접 연결할지 여부를 지정합니다.

• true: 클라이언트가 지정된 호스팅에만 작업을 보냅니다. 복제본 세트의 다른 멤버는 검색하지 않습니다.

• false: 클라이언트는 복제본 세트에 있는 모든 서버를 검색하려고 시도하고 프라이머리 멤버에게 작업을 전송합니다. 이 값은 기본값입니다.

쓰기 고려 w 옵션에 해당합니다. w 옵션은 쓰기 작업이 지정된 개수의 mongod 인스턴스 또는 태그가 지정된 mongod 인스턴스로 전파되었음을 확인하도록 요청합니다.

사용자는 number, 문자열 majority 또는 tag set을(를) 지정할 수 있습니다.

자세한 내용은 w 옵션을 참조하세요.

쓰기 고려 (write concern) 에 wtimeout 해당합니다. wtimeoutMS 는 쓰기 고려 (write concern) 에 대한 시간 제한(밀리초)을 지정합니다.

wtimeoutMS이(가) 0인 경우에는 쓰기 작업의 시간이 절대 초과되지 않습니다. 자세한 내용은 wtimeout을(를) 참조하세요.

쓰기 고려 (write concern)j 옵션 옵션에 journal 해당합니다. 옵션은 MongoDB 에 쓰기 (write) 작업이 저널 에 기록되었음을 확인 요청합니다. 자세한 내용은 j 옵션을 참조하세요.

journal 를 로 true 설정하다 하고 보다 w 작은 값을 지정하면 1 journal 이 우선합니다.

격리 레벨입니다. 다음 값 중 하나를 허용할 수 있습니다.

• local

• majority

• linearizable

• available

이 연결 문자열 옵션은 mongosh에 사용할 수 없습니다. 특정 작업에 대한 옵션으로 읽기 고려를 지정합니다.

이 연결에 대한 읽기 기본 설정을 지정합니다. 가능한 값은 다음과 같습니다.

• primary(Default(기본값))

• primaryPreferred

• secondary

• secondaryPreferred

• nearest

분산 트랜잭션 에 포함된 읽기 작업은 primary로 읽기 설정을 사용해야 합니다. 특정 트랜잭션의 모든 작업은 동일한 노드로 라우팅되어야 합니다.

이 연결 문자열 옵션은 mongo 셸에 사용할 수 없습니다. 대신 cursor.readPref() 및 Mongo.setReadPref()을(를) 참조하세요.

클라이언트가 읽기 작업에 대한 세컨더리 사용을 중단하기 전에 세컨더리가 지속될 수 있는 시간(단위: 초)을 지정합니다. 자세한 내용은 읽기 기본 설정 maxStalenessSeconds을(를) 참조하세요.

기본적으로 최대 부실도는 없으며 클라이언트는 읽기 작업을 지시할 위치를 선택할 때 보조 서버의 지연을 고려하지 않습니다.

최소 maxStalenessSeconds 값은 90 초입니다. ~ 0 90 초 사이의 값을 지정하면 오류가 발생합니다. MongoDB 드라이버는 의 maxStalenessSeconds 값을 이 생략된 경우와 -1 동일하게 "최대 비활성 없음"으로 maxStalenessSeconds 처리합니다.

태그 문서를 콜론으로 구분된 키-값 쌍의 쉼표로 구분된 목록으로 지정합니다. 예시:

• 태그 문서 { "dc": "ny", "rack": "r1" }을(를) 지정하려면 연결 문자열에 readPreferenceTags=dc:ny,rack:r1을(를) 사용하세요.

• 빈 태그 문서 { }을(를) 지정하려면 값을 설정하지 않은 상태에서 readPreferenceTags=을(를) 사용하세요.

태그 문서 목록을 지정하려면 readPreferenceTags을(를) 여러 개 사용하세요. 예시: readPreferenceTags=dc:ny,rack:r1&readPreferenceTags=

readPreferenceTags를 여러 개 사용할 때는 순서가 중요합니다. 일치하는 항목이 발견될 때까지 readPreferenceTags가 순서대로 시도됩니다. 자세한 내용은 태그 일치 순서를 참조하세요.

이 연결 문자열 옵션은 mongo 셸에 사용할 수 없습니다. 대신 cursor.readPref() 및 Mongo.setReadPref()을(를) 참조하세요.

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

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

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

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 자격 증명 (AWS 액세스 키 ID 및 비밀 액세스 키, 그리고 선택적으로 AWS 세션 토큰)을 통해 인증 을 지원 하도록 구성된 MongoDB Atlas cluster 에 연결해야 합니다. MONGODB-AWS 인증 메커니즘 에서는 를 로 설정하다 해야 authSource $external합니다.

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

Amazon Web Services 액세스 키 ID , 보안 액세스 키 또는 세션 토큰에 다음 문자가 포함된 경우 Amazon Web Services ID 해당 문자는 백분율 인코딩을 사용하여 변환해야 합니다.

$ : / ? # [ ] @

또는 Amazon Web Services 액세스 키 ID, 시크릿 액세스 키 또는 세션 토큰이 해당 AWS IAM 환경 변수를 사용하여 플랫폼에 정의된 경우 mongosh(은)는 이러한 환경 변수 값을 사용하여 인증하며, 연결 문자열에 이를 지정할 필요가 없습니다.

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

MongoDB 의 인증 시스템에 대한 자세한 내용은 자체 관리 배포 서버에 대한 인증을 참조하세요. Use x도 고려하세요. 자체 관리 배포서버에서 클라이언트를 인증하는 509 인증서 는 x509 인증 에 대한 자세한 내용을 참조하세요.

지정된 의 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>

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

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

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

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