연결 문자열 옵션

replicaSet

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

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

directConnection

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

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

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

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이 우선적으로 적용됩니다.

readConcernLevel

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

• local

• majority

• linearizable

• available

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

readPreference

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

• primary(Default(기본값))

• primaryPreferred

• secondary

• secondaryPreferred

• nearest

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

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

maxStalenessSeconds

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

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

최소 maxStalenessSeconds 값은 90초입니다. 0~90초 범위에서 값을 지정하면 오류가 발생합니다. MongoDB 드라이버는 maxStalenessSeconds 값이 -1인 경우를 '최대 비활성 없음'으로 처리하며, 이는 maxStalenessSeconds가 생략된 경우와 동일합니다.

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()을(를) 참조하세요.

authSource

사용자의 자격 증명에 연결된 데이터베이스 이름을 지정하세요. authSource가 지정되지 않으면 authSource는 연결 문자열에 지정된 defaultauthdb로 기본 설정됩니다. defaultauthdb가 지정되지 않으면 authSource는 admin로 기본 설정됩니다.

PLAIN(LDAP), GSSAPI(Kerberos) 및 MONGODB-AWS(IAM) 인증 메커니즘에서는 자격 증명 스토리지를 외부 서비스에 맡기므로, $external을 authSource로 설정해야 합니다.

연결 문자열에서 또는 --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-OIDC (OpenID Connect OIDC), authMechanismProperties ENVIRONMENT 변수도 설정하다 해야 합니다.

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

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

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

MONGODB-AWS를 사용하는 경우 AWS 액세스 키 ID를 사용자 이름으로, 시크릿 액세스 키를 비밀번호로 입력하세요. AWS 세션 토큰도 사용하는 경우에는 AWS_SESSION_TOKEN authMechanismProperties 값을 입력하세요.

$ : / ? # [ ] @

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

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

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

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>

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

ENVIRONMENT:<string>

OIDC(OpenID Connect) 환경을 설정합니다. 다음의 경우:

• Microsoft Azure, 설정하다 ENVIRONMENT:azure

• Google Cloud Platform, 설정하다 ENVIRONMENT:gcp

또한 authMechanism 을 MONGODB-OIDC 로 설정하다 해야 합니다.

gssapiServiceName

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

gssapiServiceName는 모든 클라이언트 및 MongoDB 인스턴스에 mongodb를 기본값으로 설정합니다. MongoDB 인스턴스에서 saslServiceName 설정을 변경한다면 반드시 gssapiServiceName을 해당 설정과 일치하도록 설정해야 합니다.

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