이 섹션에서는 드라이버에서 지원하는 MongoDB 연결 및 인증 옵션에 대해 설명합니다. 연결 옵션을 연결 URI의 매개 변수로 전달하여 클라이언트의 동작을 지정할 수 있습니다.
옵션 이름 | 유형 | 설명 |
|---|---|---|
minPoolSize | integer | 단일 연결 풀에 언제든지 존재해야 하는 최소 연결 수를 지정합니다. 기본값: |
maxPoolSize | integer | 특정 시간에 연결 풀이 가질 수 있는 최대 연결 수를 지정합니다. 기본값: |
waitQueueTimeoutMS (사용 중단됨) | integer | 이 옵션은 더 이상 사용되지 않습니다. 대신 클라이언트 수준 시간 제한을 설정하여 이 시간 제한을 구성할 수 있습니다. 연결이 가능해질 때까지 작업이 기다릴 수 있는 최대 대기 시간(밀리초)입니다. 기본값: |
serverSelectionTimeoutMS | integer | 예외 발생 전에 서버 선택에 성공할 때까지 드라이버가 기다리는 최대 시간(밀리초)을 지정합니다. 기본값: |
localThresholdMS | integer | 복제본 세트에 있는 MongoDB의 여러 인스턴스와 통신할 때 드라이버는 로컬 임계값을 포함하여 응답 시간이 가장 빠른(밀리초) 서버와 응답 시간이 같거나 작은 서버에만 요청을 보냅니다. 기본값: |
heartbeatFrequencyMS | integer | 클러스터에 있는 각 서버의 현재 상태를 확인하기 위해 드라이버가 대기하는 빈도(밀리초)를 지정합니다. 기본값: |
복제본 세트 | 문자열 | 제공된 연결 문자열에 여러 호스트가 포함되도록 지정합니다. 이 값이 지정되면 드라이버는 해당 세트의 모든 구성원을 찾으려고 시도합니다. 기본값: |
ssl | 부울 | MongoDB 인스턴스와의 모든 통신에서 TLS/SSL을 사용하도록 지정합니다. tls 옵션으로 대체되었습니다. 기본값: |
TLS | 부울 | MongoDB 인스턴스와의 모든 통신에서 TLS를 사용하도록 지정합니다. SSL 옵션을 대체합니다. 기본값: |
tlsInsecure | 부울 | 드라이버가 TLS 연결에 대해 잘못된 호스트 이름을 허용하도록 지정합니다. tlsAllowInvalidHostnames 를 기본값: |
tlsAllowInvalidHostnames | 부울 | 드라이버가 TLS 연결을 위해 인증서에 유효하지 않은 호스트 이름을 허용하도록 지정합니다. sslInvalidHostNameAllowed 를 대체합니다. 기본값: |
connectTimeoutMS | integer | Kotlin 드라이버가 시간 초과되기 전에 연결이 열릴 때까지 기다리는 최대 시간(밀리초)을 지정합니다. 기본값: |
socketTimeoutMS (사용 중단됨) | integer | 이 옵션은 더 이상 사용되지 않습니다. 대신 클라이언트 수준 시간 제한을 설정하여 이 시간 제한을 구성할 수 있습니다. 코틀린 (Kotlin) 운전자 제한 시간이 초과되기 전에 요청 보내거나 받기를 기다리는 최대 시간(밀리초)입니다. 기본값: |
maxIdleTimeMS | integer | 드라이버가 연결을 닫기 전에 풀링된 연결이 유휴 상태로 유지되도록 허용하는 최대 시간(밀리초)을 지정합니다. 예기치 않은 연결 끊김을 방지하려면 이 값을 애플리케이션의 예상 유휴 기간보다 높게 설정하고 방화벽 또는 프록시 연결 시간 초과보다 낮게 설정합니다. 기본값: |
maxLifeTimeMS | integer | 코틀린(Kotlin) 드라이버가 연결이 닫히기 전에 풀링된 연결을 계속 사용할 최대 시간(밀리초)을 지정합니다. 기본값: |
journal | 부울 | 연결된 MongoDB 인스턴스가 모든 쓰기에 대해 디스크의 저널 파일을 그룹 커밋할 때까지 드라이버가 기다리도록 지정합니다. 기본값: |
w | 문자열 또는 정수 | 쓰기 고려 (write concern) 를 지정합니다. 값에 대한 자세한 내용은 w 옵션에 대한 서버 설명서를 참조하세요. 기본값: |
wtimeoutMS (사용 중단됨) | integer | 이 옵션은 더 이상 사용되지 않습니다. 대신 클라이언트 수준 시간 제한을 설정하여 이 시간 제한을 구성할 수 있습니다. 쓰기 고려 (write concern) 대한 시간 제한(단위: 밀리초)입니다. 자세한 내용은 wtimeoutMS 옵션에 대한 서버 설명서를 참조하세요. 기본값: |
읽기 설정 | 문자열 | 읽기 설정을 지정합니다. 값에 대한 자세한 내용은 readPreference 옵션에 대한 서버 설명서를 참조하세요. 기본값: |
readPreferenceTags | 문자열 | 읽기 설정 태그를 지정합니다. 값에 대한 자세한 내용은 readPreferenceTags 옵션에 대한 서버 설명서를 참조하세요. 기본값: |
최대 보관 기간 | integer | 드라이버가 세컨더리와의 통신을 중지하기 전에 세컨더리가 부실한 상태가 될 수 있는 시간(초)을 지정합니다. 최소값은 90 초 또는 하트비트 빈도에 10 초를 더한 값 중 더 큰 값입니다. 자세한 내용은 maxStalenessSeconds 옵션 에 대한 서버 설명서를 참조하세요. 매개 변수를 제공하지 않거나 기본값: |
authMechanism | 문자열 | 자격 증명이 제공된 경우 드라이버가 사용해야 하는 인증 메커니즘 을 지정합니다. Default(기본값) : 기본적으로 클라이언트는 서버 버전에 따라 사용 가능한 가장 안전한 메커니즘을 선택합니다. 사용 가능한 값은 authMechanism 옵션 에 대한 서버 설명서를 참조하세요. |
authSource | 문자열 | 제공된 자격 증명의 유효성을 검사해야 하는 데이터베이스를 지정합니다. 기본값: |
authMechanismProperties | 문자열 | 지정된 인증 메커니즘에 대한 인증 속성을 콜론으로 구분된 속성 및 값 목록으로 지정합니다. 자세한 내용은 authMechanismProperties 옵션에 대한 서버 설명서를 참조하세요. 기본값: |
앱 이름 | 문자열 | 연결 핸드셰이크 중에 MongoDB 인스턴스에 제공되는 애플리케이션의 이름을 지정합니다. 서버 로그 및 프로파일링에 사용할 수 있습니다. 기본값: |
압축기 | 문자열 | 연결된 MongoDB 인스턴스로 전송된 요청을 드라이버가 압축하는 데 사용할 하나 이상의 압축 알고리즘을 지정합니다. 사용 가능한 값: 기본값: |
zlibCompressionLevel | integer | 연결된 MongoDB 인스턴스 에 대한 요청의 크기를 줄이기 위해 zlib 사용해야 하는 압축 정도를 지정합니다. 이 수준의 범위 기본값: |
retryWrites | 부울 | 지원되는 쓰기 작업이 네트워크 오류로 인해 실패한 경우 드라이버가 다시 시도하도록 지정합니다. 기본값: |
retryReads | 부울 | 지원되는 읽기 작업이 네트워크 오류로 인해 실패한 경우 드라이버가 다시 시도하도록 지정합니다. 기본값: |
serverMonitoringMode | 문자열 | 드라이버가 사용하는 서버 모니터링 프로토콜을 지정합니다. 기본값: |
uuidRepresentation | 문자열 | 읽기 및 쓰기 (write) 작업에 사용할 UUID 표현을 지정합니다. 자세한 내용은 MongoClientSettings.getUuidRepresentation() 메서드에 대한 운전자 설명서를 참조하세요. 기본값: |
directConnection | 부울 | 드라이버가 호스트에 직접 연결하도록 지정합니다. 기본값: |
maxConnecting | integer | 풀이 동시에 설정할 수 있는 최대 연결 수를 지정합니다. 기본값: |
srvServiceName | 문자열 | 운전자 시드 목록 구성하기 위해 검색하는 SRV 리소스 레코드의 서비스 이름을 지정합니다. 이 옵션을 사용하려면 연결 URI에서 DNS 시드 목록 연결 형식을 사용해야 합니다. 기본값: |
전체 옵션 목록은 ConnectionString API 참조 페이지를 참조하세요.