연결 옵션

minPoolSize

integer

단일 연결 풀에 언제든지 존재해야 하는 최소 연결 수를 지정합니다.

기본값: 0

maxPoolSize

integer

특정 시간에 연결 풀이 가질 수 있는 최대 연결 수를 지정합니다.

기본값: 100

waitQueueTimeoutMS (사용 중단됨)

integer

이 옵션은 더 이상 사용되지 않습니다. 대신 클라이언트 수준 시간 제한을 설정하여 이 시간 제한을 구성할 수 있습니다.

연결이 가능해질 때까지 작업이 기다릴 수 있는 최대 대기 시간(밀리초)입니다. 0 값은 제한이 없음을 의미합니다.

기본값: 120000(120초)

serverSelectionTimeoutMS

integer

예외 발생 전에 서버 선택에 성공할 때까지 드라이버가 기다리는 최대 시간(밀리초)을 지정합니다.

기본값: 30000(30초)

localThresholdMS

integer

복제본 세트에 있는 MongoDB의 여러 인스턴스와 통신할 때 드라이버는 로컬 임계값을 포함하여 응답 시간이 가장 빠른(밀리초) 서버와 응답 시간이 같거나 작은 서버에만 요청을 보냅니다.

기본값: 15

heartbeatFrequencyMS

integer

클러스터에 있는 각 서버의 현재 상태를 확인하기 위해 드라이버가 대기하는 빈도(밀리초)를 지정합니다.

기본값: 10000(10초)

복제본 세트

문자열

제공된 연결 문자열에 여러 호스트가 포함되도록 지정합니다. 이 값이 지정되면 드라이버는 해당 세트의 모든 구성원을 찾으려고 시도합니다.

기본값: null

ssl

부울

MongoDB 인스턴스와의 모든 통신에서 TLS/SSL을 사용하도록 지정합니다. tls 옵션으로 대체되었습니다.

기본값: false

TLS

부울

MongoDB 인스턴스와의 모든 통신에서 TLS를 사용하도록 지정합니다. SSL 옵션을 대체합니다.

기본값: false

tlsInsecure

부울

드라이버가 TLS 연결에 대해 잘못된 호스트 이름을 허용하도록 지정합니다. tlsAllowInvalidHostnames 를 true 로 설정한 것과 같은 효과가 있습니다. 다른 방법으로 TLS 보안 제약 조건을 구성하려면 사용자 지정 SSLContext를 사용하세요.

기본값: false

tlsAllowInvalidHostnames

부울

드라이버가 TLS 연결을 위해 인증서에 유효하지 않은 호스트 이름을 허용하도록 지정합니다. sslInvalidHostNameAllowed 를 대체합니다.

기본값: false

connectTimeoutMS

integer

Kotlin 드라이버가 시간 초과되기 전에 연결이 열릴 때까지 기다리는 최대 시간(밀리초)을 지정합니다. 0 값은 드라이버가 연결이 열릴 때까지 기다리는 동안 시간이 초과되지 않도록 합니다.

기본값: 10000(10초)

socketTimeoutMS (사용 중단됨)

integer

이 옵션은 더 이상 사용되지 않습니다. 대신 클라이언트 수준 시간 제한을 설정하여 이 시간 제한을 구성할 수 있습니다.

코틀린 (Kotlin) 운전자 제한 시간이 초과되기 전에 요청 보내거나 받기를 기다리는 최대 시간(밀리초)입니다. 0 값은 운전자 요청 보내거나 받기를 기다리는 동안 시간이 초과되지 않도록 합니다.

기본값: 0

maxIdleTimeMS

integer

드라이버가 연결을 닫기 전에 풀링된 연결이 유휴 상태로 유지되도록 허용하는 최대 시간(밀리초)을 지정합니다. 0 값은 드라이버 풀링된 연결의 유휴 상태를 허용하는 기간에 상한이 없음을 나타냅니다.

예기치 않은 연결 끊김을 방지하려면 이 값을 애플리케이션의 예상 유휴 기간보다 높게 설정하고 방화벽 또는 프록시 연결 시간 초과보다 낮게 설정합니다.

기본값: 0

maxLifeTimeMS

integer

코틀린(Kotlin) 드라이버가 연결이 닫히기 전에 풀링된 연결을 계속 사용할 최대 시간(밀리초)을 지정합니다. 0 값은 드라이버가 풀링된 연결을 열린 상태로 유지할 수 있는 기간에 상한이 없도록 합니다.

기본값: 0

journal

부울

연결된 MongoDB 인스턴스가 모든 쓰기에 대해 디스크의 저널 파일을 그룹 커밋할 때까지 드라이버가 기다리도록 지정합니다.

기본값: false

w

문자열 또는 정수

Specifies the write concern. For more information on values, see the server documentation for the w option.

기본값: 1

wtimeoutMS (사용 중단됨)

integer

이 옵션은 더 이상 사용되지 않습니다. 대신 클라이언트 수준 시간 제한을 설정하여 이 시간 제한을 구성할 수 있습니다.

Time limit, in milliseconds, for the write concern. For more information, see the server documentation for the wtimeoutMS option. A value of 0 instructs the driver to never time out write operations.

기본값: 0

읽기 설정

문자열

Specifies the read preference. For more information on values, see the server documentation for the readPreference option.

기본값: primary

readPreferenceTags

문자열

Specifies the read preference tags. For more information on values, see the server documentation for the readPreferenceTags option.

기본값: null

최대 보관 기간

integer

Specifies, in seconds, how stale a secondary can be before the driver stops communicating with that secondary. The minimum value is either 90 seconds or the heartbeat frequency plus 10 seconds, whichever is greater. For more information, see the server documentation for the maxStalenessSeconds option. Not providing a parameter or explicitly specifying -1 indicates that there should be no staleness check for secondaries.

기본값: -1

authMechanism

문자열

자격 증명이 제공된 경우 드라이버가 사용해야 하는 인증 메커니즘 을 지정합니다.

Default: By default, the client picks the most secure mechanism available based on the server version. For possible values, see the server documentation for the authMechanism option.

authSource

문자열

제공된 자격 증명의 유효성을 검사해야 하는 데이터베이스를 지정합니다.

기본값: admin

authMechanismProperties

문자열

Specifies authentication properties for the specified authentication mechanism as a list of colon-separated properties and values. For more information, see the server documentation for the authMechanismProperties option.

기본값: null

앱 이름

문자열

연결 핸드셰이크 중에 MongoDB 인스턴스에 제공되는 애플리케이션의 이름을 지정합니다. 서버 로그 및 프로파일링에 사용할 수 있습니다.

기본값: null

압축기

문자열

연결된 MongoDB 인스턴스로 전송된 요청을 드라이버가 압축하는 데 사용할 하나 이상의 압축 알고리즘을 지정합니다. 사용 가능한 값: zlib, snappy, zstd.

기본값: null

zlibCompressionLevel

integer

연결된 MongoDB 인스턴스 에 대한 요청의 크기를 줄이기 위해 zlib 사용해야 하는 압축 정도를 지정합니다. 이 수준의 범위 -1 부터 9까지이며, 값이 낮을수록 압축 속도가 빨라지지만 요청 크기가 커지며, 값이 클수록 압축 속도가 느려지지만 요청 크기는 작아집니다.

기본값: null

retryWrites

부울

지원되는 쓰기 작업이 네트워크 오류로 인해 실패한 경우 드라이버가 다시 시도하도록 지정합니다.

기본값: true

retryReads

부울

지원되는 읽기 작업이 네트워크 오류로 인해 실패한 경우 드라이버가 다시 시도하도록 지정합니다.

기본값: true

serverMonitoringMode

문자열

드라이버가 사용하는 서버 모니터링 프로토콜을 지정합니다. auto로 설정하면 드라이버가 실행되는 환경에 따라 모니터링 모드가 결정됩니다. 드라이버는 FaaS(Function-as-a-Service) 환경에서 poll 모드를 사용하고 다른 환경에서는 stream 모드를 사용합니다.

기본값: auto

uuidRepresentation

문자열

읽기 및 쓰기 (write) 작업에 사용할 UUID 표현을 지정합니다. 자세한 내용은 MongoClientSettings.getUuidRepresentation() 메서드에 대한 운전자 설명서를 참조하세요.

기본값: unspecified

directConnection

부울

드라이버가 호스트에 직접 연결하도록 지정합니다.

기본값: false

maxConnecting

integer

풀이 동시에 설정할 수 있는 최대 연결 수를 지정합니다.

기본값: 2

srvServiceName

문자열

운전자 시드 목록 구성하기 위해 검색하는 SRV 리소스 레코드의 서비스 이름을 지정합니다. 이 옵션을 사용하려면 연결 URI에서 DNS 시드 목록 연결 형식을 사용해야 합니다.

기본값: mongodb