연결 옵션

앱 이름

문자열

none

Client 인스턴스가 핸드쉐이크의 일부로 서버에 보내는 애플리케이션 이름을 지정합니다.
appName 을 지정하면 서버 로그를 사용하여 어떤 Client 인스턴스가 서버에 연결되어 있는지 확인하는 데 도움이 될 수 있습니다.

authMechanism

문자열

none

사용할 인증 메커니즘을 지정합니다. 이 옵션을 지정하지 않으면 드라이버는 기본 인증 메커니즘을 사용합니다. Rust 드라이버의 인증에 대해 자세히 알아보려면 인증 메커니즘 가이드를 참조하세요.

authMechanismProperties

문자열

none

authMechanism 옵션에 설정된 인증 메커니즘에 대한 추가 속성을 지정합니다.

authSource

문자열

설명 참조

인증에 사용되는 데이터베이스를 지정합니다.
이 옵션의 기본값은 SCRAM 기반 인증 메커니즘의 경우 admin, MONGODB-X509 메커니즘의 경우 $external, PLAIN 메커니즘의 경우 데이터베이스 이름 또는 $external 입니다.

압축기

쉼표로 구분된 문자열 목록

none

Client 인스턴스가 지정된 순서대로 사용하는 압축기를 지정합니다. 네트워크 압축에 대해 자세히 알아보려면 네트워크 압축 가이드를 참조하세요.

connectTimeoutMS

Non-negative integer

10000 (10초)

서버에 연결을 시도할 때 각 기본 TCP 스트림에 전달되는 연결 제한 시간(밀리초)을 지정합니다.

directConnection

부울

false

cluster의 모든 서버를 검색하여 연결하는 대신 Client 인스턴스를 단일 호스트에 직접 연결할지 여부를 지정합니다.

heartbeatFrequencyMS

500보다 크거나 이와 동일한 정수

10000 (10초)

각 모니터링 스레드가 서버 검사를 수행하는 사이에 대기하는 시간(밀리초)을 지정합니다.

journal

부울

false

작업이 온디스크 저널로 전파되었음을 확인 요청합니다.

localThresholdMS

Non-negative integer

15

드라이버와 서버 간의 평균 왕복 시간이 모든 적합한 서버 중 가장 짧은 왕복 시간과 비교하여 지속될 수 있는 시간(밀리초)을 지정합니다.
0 값은 지연 시간 창이 없음을 나타내므로 가장 낮은 평균 왕복 시간을 가진 서버만 사용 가능합니다.

maxIdleTimeMS

Non-negative integer

0 (no limit)

연결이 서버에 의해 닫히기 전에 연결 풀에서 유휴 상태로 유지될 수 있는 시간(밀리초)을 지정합니다.
0 값은 클라이언트가 유휴 연결을 닫지 않음을 나타냅니다. 예치치 못한 연결 끊김을 방지하려면 이 값을 애플리케이션의 예상 유휴 기간보다 높게 설정하고 방화벽 또는 프록시 연결 시간 초과보다 낮게 설정합니다.

최대 보관 기간

-1, 또는 다음보다 크거나 같은 정수 90

-1

주어진 작업의 고려 대상이 될 수 있는 세컨더리 노드가 프라이머리 노드보다 최대 지연 시간(초)을 지정합니다.
이 옵션의 값은 최소 90이어야 하며, 그렇지 않으면 작업에서 오류가 발생합니다. 값이 -1 이면 최대 지연이 없습니다.

maxPoolSize

Non-negative integer

10

Client 인스턴스가 주어진 서버에 대한 연결 풀에서 만들 수 있는 최대 연결 수를 지정합니다.
maxPoolSize 연결의 값이 체크아웃된 동안 작업을 시도하면 작업이 진행 중인 작업이 끝나고 연결이 풀로 복귀될 때까지 기다립니다.

minPoolSize

Non-negative integer

0

특정 시간에 서버의 연결 풀에서 사용 가능한 최소 연결 수를 지정합니다.
푸를에 minPoolSize 개 미만의 연결이 있는 경우 서버는 배경에서 minPoolSize값까지 연결을 추가합니다.

readConcernLevel

문자열

none

Client 인스턴스 에서 수행되는 작업에 대한 기본값 읽기 고려 (read concern) 를 지정합니다. 학습 내용은 서버 매뉴얼의 읽기 고려 를 참조하세요.

읽기 설정

문자열

primary

드라이버가 읽기 작업을 복제본 세트의 멤버로 라우팅하는 방법을 지정합니다. 자세한 내용은 MongoDB Server 매뉴얼의 읽기 설정 을 참조하세요.

readPreferenceTags

쉼표로 구분된 키-값 쌍 목록

none

작업에 고려되는 복제본 세트 멤버를 지정합니다. 이 키의 각 인스턴스는 별도의 태그 세트입니다. 드라이버는 세트에서 각 태그가 있는 하나 이상의 서버를 찾을 때까지 각 태그 세트를 확인합니다.

복제본 세트

문자열

none

Client 인스턴스가 연결되는 복제본 세트의 이름을 지정합니다.

retryReads

부울

true

작업이 실패할 경우 클라이언트가 읽기 작업을 다시 시도할지 여부를 지정합니다.

serverSelectionTimeoutMS

Non-negative integer

30000 (30초)

Client 인스턴스가 시간 초과되기 전에 작업에 대한 서버를 선택하려고 할 때 대기하는 시간(밀리초)을 지정합니다.

TLS

부울

false

서버와의 연결에 사용할 Client 인스턴스에 대한 TLS 구성을 지정합니다. 기본적으로 TLS는 꺼져 있습니다.

tlsAllowInvalidCertificates

부울

false

서버가 유효하지 않은 인증서를 제시하는 경우 Client 인스턴스가 오류를 반환할지 여부를 지정합니다.
이 옵션은 테스트 환경에서만 true 로 설정하여 애플리케이션에 취약점이 생기지 않도록 하는 것이 좋습니다.

tlsCAFile

문자열

설명 참조

Client 인스턴스가 TLS에 사용하는 CA(인증서 발급 기관) 파일의 경로를 지정합니다.
이 옵션을 지정하지 않으면 드라이버는 webpki-roots 크레이트의 Mozilla 루트 인증서를 사용합니다.

tlsCertificateKeyFile

문자열

none

Client 인스턴스가 서버에 제시하여 신원을 확인하는 인증서 파일의 경로를 지정합니다.
이 옵션을 설정하지 않으면 Client 인스턴스는 서버에 신원을 확인하려고 시도하지 않습니다.

tlsInsecure

부울

false

서버가 유효하지 않은 인증서를 제시하는 경우 Client 인스턴스가 오류를 반환할지 여부를 지정합니다.
이 옵션은 테스트 환경에서만 true 로 설정하여 애플리케이션에 취약점이 생기지 않도록 하는 것이 좋습니다.

w

음수가 아닌 정수 또는 문자열

none

작업이 특정 수 또는 다양한 서버에 전파되었음을 확인하도록 요청합니다.
자세히 알아보려면 서버 매뉴얼의 쓰기 고려 (write concern) 를 참조하세요.

wTimeoutMS

Non-negative integer

시간 초과 없음

쓰기 고려 (write concern)의 제한 시간(밀리초)을 지정합니다. 작업이 제한 시간 내에 요청된 수준으로 전파되지 않으면 드라이버에서 오류가 발생합니다.

zlibCompressionLevel

-1과 9 사이의 정수(포함)

-1

이 압축기를 사용하는 경우 zlib 압축의 레벨 필드를 지정합니다.
-1 값을 설정하면 기본 압축 레벨(6)이 선택됩니다.
0 값을 설정하면 압축이 없음을 지정하고, 9 값을 설정하면 최대 압축을 지정합니다.
네트워크 압축에 대해 자세히 학습하려면 네트워크 압축 가이드를 참조하세요.