연결 옵션
이 섹션에서는 드라이버에서 지원하는 MongoDB 연결 및 인증 옵션에 대해 설명합니다. 연결 옵션을 연결 URI의 매개 변수로 전달하여 클라이언트의 동작을 지정할 수 있습니다.
옵션 이름 | 유형 | 설명 |
|---|---|---|
minPoolSize | integer | 단일 연결 풀에 언제든지 존재해야 하는 최소 연결 수를 지정합니다. 기본값: 0 |
maxPoolSize | integer | 특정 시간에 연결 풀이 가질 수 있는 최대 연결 수를 지정합니다. 기본값: 100 |
waitQueueTimeoutMS | integer | 연결이 가능해질 때까지 스레드가 대기할 수 있는 최대 시간(밀리초)을 지정합니다. 기본값: 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를 기본값: false |
tlsAllowInvalidHostnames | 부울 | 드라이버가 TLS 연결을 위해 인증서에 유효하지 않은 호스트 이름을 허용하도록 지정합니다. sslInvalidHostNameAllowed를 대체합니다. 기본값: false |
connectTimeoutMS | integer | Java 드라이버가 시간 초과되기 전에 연결이 열릴 때까지 기다리는 최대 시간(밀리초)을 지정합니다. 기본값: 10000(10초) |
socketTimeoutMS | integer | Java 드라이버가 시간 초과되기 전에 요청을 보내거나 받기를 기다리는 최대 시간(밀리초)을 지정합니다. 기본값: 0 |
maxIdleTimeMS | integer | Java 드라이버가 연결이 닫히기 전에 풀링된 연결이 유휴 상태로 유지되도록 허용하는 최대 시간(밀리초)을 지정합니다. 기본값: 0 |
maxLifeTimeMS | integer | Java 드라이버가 연결이 닫히기 전에 풀링된 연결을 계속 사용할 최대 시간(밀리초)을 지정합니다. 기본값: 0 |
일지 | 부울 | 연결된 MongoDB 인스턴스가 모든 쓰기에 대해 디스크의 저널 파일을 그룹 커밋할 때까지 드라이버가 기다리도록 지정합니다. 기본값: false |
w | 문자열 또는 정수 | 쓰기 고려를 지정합니다. 값에 대한 자세한 내용은 w 옵션에 대한 서버 설명서를 참조하세요. 기본값: 1 |
wtimeoutMS | integer | 쓰기 고려에 대한 시간 제한(밀리초)을 지정합니다. 자세한 내용은 wtimeoutMS 옵션 에 대한 서버 설명서를 참조하세요. 기본값: 0 |
읽기 설정 | 문자열 | 읽기 설정을 지정합니다. 값에 대한 자세한 내용은 readPreference 옵션에 대한 서버 설명서를 참조하세요. 기본값: primary |
readPreferenceTags | 문자열 | 읽기 설정 태그를 지정합니다. 값에 대한 자세한 내용은 readPreferenceTags 옵션에 대한 서버 설명서를 참조하세요. 기본값: null |
최대 보관 기간 | integer | 드라이버가 세컨더리와의 통신을 중지하기 전에 세컨더리가 부실한 상태가 될 수 있는 시간(초)을 지정합니다. 최소값은 90 초 또는 하트비트 빈도에 10 초를 더한 값 중 더 큰 값입니다. 자세한 내용은 maxStalenessSeconds 옵션 에 대한 서버 설명서를 참조하세요. 매개 변수를 제공하지 않거나 기본값: -1 |
authMechanism | 문자열 | 자격 증명이 제공된 경우 드라이버가 사용하는 인증 메커니즘을 지정합니다. Default(기본값) : 기본적으로 클라이언트는 서버 버전에 따라 사용 가능한 가장 안전한 메커니즘을 선택합니다. 사용 가능한 값은 authMechanism 옵션 에 대한 서버 설명서를 참조하세요. |
authSource | 문자열 | 제공된 자격 증명의 유효성이 검증된 데이터베이스를 지정합니다. 기본값: admin |
authMechanismProperties | 문자열 | 지정된 인증 메커니즘에 대한 인증 속성을 콜론으로 구분된 속성 및 값 목록으로 지정합니다. 자세한 내용은 authMechanismProperties 옵션에 대한 서버 설명서를 참조하세요. 기본값: null |
앱 이름 | 문자열 | 연결 핸드셰이크 중에 MongoDB 인스턴스에 제공되는 애플리케이션의 이름을 지정합니다. 서버 로그 및 프로파일링에 사용할 수 있습니다. 기본값: null |
압축기 | 문자열 | 연결된 MongoDB 인스턴스로 전송된 요청을 드라이버가 압축하는 데 사용할 하나 이상의 압축 알고리즘을 지정합니다. 사용 가능한 값: 기본값: null |
zlibCompressionLevel | integer | 가 압축하는 정도를 지정합니다. 연결된 인스턴스에 대한 요청의 크기를 zlib 줄이는 MongoDB 데 사용됩니다. 이 수준의 범위는 기본값: null |
쓰기 재시도 | 부울 | 지원되는 쓰기 작업을 네트워크 오류로 인해 완료할 수 없는 경우 드라이버가 다시 시도하도록 지정합니다. 기본값: true |
retryReads | 부울 | 지원되는 읽기 작업을 네트워크 오류로 인해 완료할 수 없는 경우 드라이버가 다시 시도하도록 지정합니다. 기본값: true |
serverMonitoringMode | 문자열 | 드라이버가 사용하는 서버 모니터링 프로토콜을 지정합니다. 기본값: auto |
uuidRepresentation | 문자열 | 읽기 및 쓰기 작업에 사용할 UUID 표현을 지정합니다. 자세한 내용은 MongoClientSettings.getUuidRepresentation() 메서드에 대한 드라이버 설명서를 참조하세요. 기본값: unspecified |
directConnection | 부울 | 드라이버가 호스트에 직접 연결하도록 지정합니다. 기본값: false |
maxConnecting | integer | 풀이 동시에 설정할 수 있는 최대 연결 수를 지정합니다. 기본값: 2 |
srvServiceName | 문자열 | SRV 리소스 레코드 의 서비스 이름을 지정합니다. 드라이버는 시드 목록 을 구성하기 위해 검색합니다. 이 옵션을 사용하려면 연결 URI 에서 DNS 시드 목록 연결 형식 을 사용해야 합니다. 기본값: mongodb |
전체 옵션 목록을 보려면 ConnectionString API 설명서를 참조하세요.