연결 URI 옵션 지정

개요

이 섹션에서는 Java Reactive Streams 운전자 에서 연결 URI의 매개변수로 전달할 수 있는 MongoDB 연결 및 인증 옵션에 대해 설명합니다.

연결 URI 사용

연결 URI를 MongoClient 생성자에 전달하는 경우 문자열에 연결 옵션을 <name>=<value> 쌍으로 포함할 수 있습니다. 다음 예시에서 연결 URI에는 값이 60000인 connectTimeoutMS 옵션과 값이 true인 tls 옵션이 포함되어 있습니다.

public class MongoConnection {
public static void main(String[] args) {
    String uri = "mongodb://<hostname>:<port>/?connectTimeoutMS=60000&tls=true";
    try (MongoClient client = MongoClients.create(uri)) {
            // Use client here
        }
    }
}

연결 옵션

다음 섹션에서는 Java Reactive Streams 운전자 에서 사용할 수 있는 연결 옵션에 대해 설명합니다. 이러한 옵션을 연결 URI의 매개 변수로 전달하여 클라이언트 의 동작을 지정할 수 있습니다.

인증

연결 옵션	설명
authMechanism	Java Reactive Streams 운전자 애플리케이션 인증하는 데 사용하는 메커니즘을 설정합니다. 유효한 옵션은 클래스 ConnectionString API 문서에 정의되어 있습니다. 데이터 유형: `String` 기본값: `"SCRAM-SHA-256"` MongoDB v 에 연결할4 0 때. 이상. `"SCRAM-SHA-1"` MongoDB 에 연결할 때3 0 v. ~3 13v.. 연결 URI 예시: `authMechanism=MONGODB-X509`
authMechanismProperties	인증 메커니즘에 특유한 옵션을 설정합니다. 데이터 유형: `String` 기본값: `""` 연결 URI 예시: `authMechanismProperties=AWS_SESSION_TOKEN:12435`
authSource	인증 자격 증명의 소스를 설정합니다. 소스는 일반적으로 데이터베이스입니다. 이 옵션은 `authMechanism` `MONGO-CR`이 로 설정된 경우에만 적용됩니다. 데이터 유형: `String` 기본값: 연결 URI의 데이터베이스 또는 제공되지 `"admin"` 않은 경우 연결 URI 예시: `authSource=admin`
사용자 이름	인증을 위한 사용자 이름을 설정합니다. 이 옵션이 연결 URI에 포함되면 백분율 에스케이프해야 합니다. 데이터 유형: `String` 기본값: `""` 연결 URI 예시: `username=my+user`
비밀번호	인증용 비밀번호를 설정합니다. 이 옵션이 연결 URI에 포함되면 백분율 에스케이프해야 합니다. 데이터 유형: `String` 기본값: `""` 연결 URI 예시: `password=strong+password`

연결 구성

연결 옵션	설명
connectTimeoutMS	시간이 초과되기 전에 연결이 가질 수 있는 시간(밀리초 단위) 을 설정합니다. 지정된 시간 내에 작업이 완료되지 않으면 Java Reactive Streams 드라이버가 시간 초과 예외를 발생시킵니다. 데이터 유형: `Integer` 기본값: `null` 연결 URI 예시: `connectTimeoutMS=6000`
maxIdleTimeMS	연결이 제거되거나 닫히기 전에 풀에서 유휴 상태로 유지될 수 있는 최대 시간(밀리초)을 설정합니다. 예기치 않은 연결 끊김을 방지하려면 이 값을 애플리케이션의 예상 유휴 기간보다 높게 설정하고 방화벽 또는 프록시 연결 시간 초과보다 낮게 설정합니다. 데이터 유형: `Integer` 기본값: `null` 연결 URI 예시: `maxIdleTimeMS=6000`
maxLifeTimeMS	푸린 연결의 최대 수명을 밀리초 단위로 설정합니다. 작업이 지정된 시간 내에 완료되지 않으면 Java Reactive Streams 드라이버가 연결을 닫습니다. 데이터 유형: `Integer` 기본값: `null` 연결 URI 예시: `maxLifeTimeMS=6000`
socketTimeoutMS (사용 중단됨)	이 옵션은 더 이상 사용되지 않습니다. 대신 클라이언트 수준 시간 제한을 설정하여이 시간 제한을 구성할 수 있습니다. 소켓에서 수신하는 데 걸릴 수 있는 시간(밀리초) 이 시간이 지나면 타임아웃됩니다. 지정된 시간 내에 작업이 완료되지 않으면 Java Reactive Streams 드라이버가 타임아웃 예외를 발생시킵니다. 데이터 유형: `Integer` 기본값: `null` 연결 URI 예시: `socketTimeoutMS=6000`
ssl	TLS/SSL을 사용하여 연결할 지 여부를 설정합니다. 데이터 유형: `boolean` 기본값: `null` 연결 URI 예시: `ssl=true`
sslInvalidHostNameAllowed	TLS/SSL 연결의 경우 유효하지 않은 호스트 이름을 허용합니다. 데이터 유형: `boolean` 기본값: `null` 연결 URI 예시: `sslInvalidHostNameAllowed=true`
TLS	TLS를 사용하여 연결할 지 여부를 설정합니다. `ssl` 옵션을 대체합니다. 데이터 유형: `boolean` 기본값: `null` 연결 URI 예시: `tls=true`
tlsAllowInvalidHostnames	TLS 연결에 대해 유효하지 않은 호스트 이름을 허용합니다. `sslInvalidHostNameAllowed` 옵션을 대체합니다. 데이터 유형: `boolean` 기본값: `null` 연결 URI 예시: `tlsAllowInvalidHostnames=true`
tlsInsecure	TLS를 사용하여 연결할 때 안전하지 않은 TLS 연결을 활성화합니다. 데이터 유형: `boolean` 기본값: `null` 연결 URI 예시: `tlsInsecure=true`

연결 풀 구성

연결 옵션	설명
maxConnecting	풀이 동시에 설정할 수 있는 최대 연결 수를 설정합니다. 데이터 유형: `Integer` 기본값: `null` 연결 URI 예시: `maxConnecting=5`
maxPoolSize	연결 풀의 최대 연결 수를 설정합니다. 연결 풀에 `maxPoolSize` 개의 연결이 열려 있는 동안 작업에 새 연결이 필요한 경우 새 작업은 새 연결이 열리기를 기다립니다. 이 대기 시간을 제한하려면 단일 타임아웃 설정을 사용합니다. 자세한 내용은 서버 실행 시간 제한 가이드를 참조하세요. 데이터 유형: `Integer` 기본값: `null` 연결 URI 예시: `maxPoolSize=5`
minPoolSize	연결 풀의 최소 연결 수를 설정합니다. 데이터 유형: `Integer` 기본값: `null` 연결 URI 예시: `minPoolSize=3`
waitQueueTimeoutMS (사용 중단됨)	이 옵션은 더 이상 사용되지 않습니다. 대신 클라이언트 수준 시간 제한을 설정하여이 시간 제한을 구성할 수 있습니다. 사용 중인 연결이 사용 가능해지거나 연결이 생성되어 설정되기 시작되기 전에 대기할 수 있는 최대 시간(밀리초). 데이터 유형: `Integer` 기본값: `null` 연결 URI 예시: `waitQueueTimeoutMS=6000`

CompressorConfiguration

연결 옵션	설명
압축기	서버에 전송되거나 서버에서 수신하는 유선 프로토콜 메시지에 대해 우선순위별로 선호하는 압축 유형을 설정합니다. 압축 유형은 쉼표로 구분된 목록으로 전달되어야 합니다. 드라이버는 서버가 지원하는 이러한 압축 유형 중 첫 번째를 사용합니다. 데이터 유형: `String` 기본값: `null` 연결 URI 예시: `compressors=snappy,zstd,zlib`
zlibCompressionLevel	zlib에 사용할 압축 수준을 설정합니다. 이 옵션은 `-1` 에서 `9`까지의 정수 값을 허용합니다. - -1: (기본값). zlib는 기본값 압축 수준(일반적으로 `6`)을 사용합니다. - 0: 압축이 없습니다. - 1: 속도는 가장 빠르지만 압축률은 가장 낮습니다. - 9: 압축률은 가장 높지만 속도가 가장 느립니다. 데이터 유형: `Integer` 기본값: `-1` 연결 URI 예시: `zLibCompressionLevel=3`

연결 옵션

설명

압축기

서버에 전송되거나 서버에서 수신하는 유선 프로토콜 메시지에 대해 우선순위별로 선호하는 압축 유형을 설정합니다.
압축 유형은
쉼표로 구분된 목록으로 전달되어야 합니다. 드라이버는
서버가 지원하는 이러한 압축 유형 중 첫 번째를 사용합니다.

데이터 유형: String
기본값: null
연결 URI 예시: compressors=snappy,zstd,zlib

zlibCompressionLevel

zlib에 사용할 압축 수준을 설정합니다. 이 옵션은
-1 에서 9까지의 정수 값을 허용합니다.

- -1: (기본값). zlib는 기본값 압축 수준(일반적으로 6)을 사용합니다.
- 0: 압축이 없습니다.
- 1: 속도는 가장 빠르지만 압축률은 가장 낮습니다.
- 9: 압축률은 가장 높지만 속도가 가장 느립니다.

데이터 유형: Integer
기본값: -1
연결 URI 예시: zLibCompressionLevel=3

일반 구성

연결 옵션	설명
directConnection	드라이버가 호스트에 직접 연결하는지 여부를 설정합니다. 데이터 유형: `boolean` 기본값: `null` 연결 URI 예시: `directConnection=true`
loadBalanced	드라이버가 로드 밸런서를 사용하여 MongoDB에 연결하는 지 여부를 설정합니다. `true`일 경우 드라이버는 로드 밸런서를 통해 연결하는 것으로 간주합니다. 데이터 유형: `boolean` 기본값: `null` 연결 URI 예시: `directConnection=true`
retryWrites	네트워크 오류로 인해 지원되는 쓰기 작업이 실패한 경우 드라이버가 다시 시도할지 여부를 설정합니다. 데이터 유형: `boolean` 기본값: `True` 연결 URI 예시: `retryWrites=true`
retryReads	네트워크 오류로 인해 지원되는 읽기 작업이 실패한 경우 드라이버가 다시 시도할 지 여부를 설정합니다. 데이터 유형: `boolean` 기본값: `True` 연결 URI 예시: `retryReads=true`
uuidRepresentation	Java Reactive Streams 운전자 UUID 인스턴스를 인코딩하는 데 사용하는 메커니즘을 설정합니다. 유효한 모든 옵션 목록은 Uuid 표현 API 문서를 참조하세요. 데이터 유형: `String` 기본값: `unspecified` 연결 URI 예시: `uuidRepresentation=unspecified`

참고

Intelligent Workload Management(IWM)의 로드 차단

SystemOverloadedError 또는 RetryableError 레이블의 오류로 인해 애플리케이션 에 장애가 발생하거나 애플리케이션 로그에 표시되는 경우, 클러스터 에서 부하 차단이 활성화되어 있을 수 있으며 운전자 이를 지원하는 버전으로 업그레이드되지 않을 수 있습니다. MongoDB Java Reactive Streams 드라이버 버전 5.8 이상으로 업그레이드하는 것이 좋습니다. 업그레이드 후에도 이러한 오류가 계속 표시되면 로드 차단 구성 검토와 같은 서버 사이드 변경이나 사용자 지정 오류 처리 또는 클라이언트 사이드 요청 스로틀링 구현과 같은 애플리케이션 사이드 변경을 통해 문제를 주소 수 있습니다. 상황에 따라 애플리케이션 측 변경이 선호되거나 필요할 수 있습니다.

로드 차단은 IWM의 기능 으로, 지속적인 과부하 상태에서 과도한 작업을 거부하여 서버 로드를 관리 도움이 됩니다. 이 기능 MongoDB 9.0 이상에서 사용할 수 있습니다.

IWM 또는 과부하 오류 처리에 대한 자세한 내용은 Atlas 설명서의 Intelligent Workload Management 페이지 또는 Overload Errors 페이지를 참조하세요.

프록시 구성

연결 옵션	설명
proxyHost	연결을 수립하기 위한 SOCKS5 프록시 호스트를 설정합니다. `proxyHost` 의 값은 유효한 IPv4 주소, IPv6 주소 또는 도메인 이름일 수 있습니다. `proxyPassword`, `proxyUsername` 또는 `proxyPort` 중 하나라도 지정된 경우 필수입니다. 데이터 유형: `String` 기본값: `null` 연결 URI 예시: `proxyHost=example.com`
proxyPort	SOCKS5 프록시 서버의 포트 번호를 설정합니다. 음수가 아닌 정수여야 합니다. 데이터 유형: `Integer` 기본값: `null` 연결 URI 예시: `proxyPort=27`
proxyUsername	프록시 서버에 인증할 사용자 이름을 설정합니다. `proxyPassword` 이 지정된 경우 필수입니다. 데이터 유형: `String` 기본값: `null` 연결 URI 예시: `proxyUsername=example`
proxyPassword	프록시 서버에 대한 인증을 위한 비밀번호를 설정합니다. `proxyPassword` 이(가) 지정된 경우에 필수입니다. 데이터 유형: `String` 기본값: `null` 연결 URI 예시: `proxyPassword=password`

읽기 설정 구성

연결 옵션	설명
읽기 설정	이 연결에 대한 읽기 설정(read preference)을 설정합니다. 열거한 값은 다음과 같습니다. `primary`, `primaryPreferred`, `secondary`, `secondaryPreferred` 및 `nearest`. 데이터 유형: `Enum` 기본값: `primary` 연결 URI 예시: `readPreference.primary`
readPreferenceTags	`dc:ny,rack:1` `readPreferenceTags` `readPreferenceTags` 콜론으로`String` 구분된 키-값 쌍의`null` 쉼표로 구분된 목록으로 태그 세트 지정합니다(예:). 모든 키와 값의시작과 끝에서 공백이 제거됩니다. 태그를 지정하다 세트 목록을 지정하려면 세미콜론으로 구분된 를 여러 개 사용합니다. 에 대해 자세히 학습 클래스 ConnectionString API 설명서를 참조하세요. 데이터 유형: 기본값: 연결 URI 예시:`readPreferenceTags=dc:ny`
최대 보관 기간	최대 비활성 상태를 초 단위로 설정합니다. 비활성 상태에 대한 자세한 학습 은 클래스 ConnectionString API 설명서를 참조하세요. 데이터 유형: `Integer` 기본값: `null` 연결 URI 예시: `maxStalenessSeconds=60`

복제본 세트 구성

연결 옵션	설명
복제본 세트	연결할 복제본 세트의 이름을 지정합니다. 데이터 유형: `String` 기본값: `null` 연결 URI 예시: `replicaSet=replicaSet`

서버 구성

연결 옵션	설명
앱 이름	애플리케이션의 논리적 이름을 설정합니다. 클라이언트는 서버에 애플리케이션을 식별하기 위해 애플리케이션 이름을 사용할 수 있습니다. 서버 로그, 느린 쿼리 로그 및 프로필 컬렉션에 사용할 수 있습니다. 데이터 유형: `String` 기본값: `null` 연결 URI 예시: `appName=name`
heartbeatFrequencyMS	클러스터에 있는 각 서버의 현재 상태를 확인하는 드라이버의 빈도(밀리초). 데이터 유형: `Integer` 기본값: `null` 연결 URI 예시: `heartbeatFrequencyMS=6000`
localThresholdMS	요청을 보내기 위해 여러 MongoDB 서버 중에서 선택하는 핑 시간 임계값을 설정합니다. 이 값이 설정되면 드라이버는 핑 시간이 가장 빠른 서버에 로컬 임계값을 더한 값보다 작거나 같은 서버에만 요청을 보냅니다. 데이터 유형: `Integer` 기본값: `null` 연결 URI 예시: `localThresholdMS=6000`
serverMonitoringMode	사용할 모니터링 프로토콜을 정의하는 서버 모니터링 모드를 설정합니다. 열거된 값은 `stream`, `poll`, `auto`입니다. 데이터 유형: `Enum` 기본값: `auto` 연결 URI 예시: `serverMonitoringMode.auto`
serverSelectionTimeoutMS	운전자가 예외를 발생시키기 전에 서버 선택이 성공할 때까지 기다릴 시간을 설정합니다. 데이터 유형: `Integer` 기본값: `null` 연결 URI 예시: `serverSelectionTimeoutMS=6000`

SRV 구성

연결 옵션	설명
srvServiceName	SRV 서비스 이름을 설정합니다. 자세한 학습 은 ClusterSettings.getSrvServiceName() API 문서를 참조하세요. 데이터 유형: `String` 기본값: `"mongodb"` 연결 URI 예시: `srvServiceName=mongodb`
srvMaxHosts	SRV 기록에서 연결할 최대 호스트 수를 설정합니다. 데이터 유형: `Integer` 기본값: `null` 연결 URI 예시: `srvMaxHosts=5`

쓰기 고려 구성

연결 옵션	설명
안전한	드라이버가 모든 쓰기가 MongoDB 서버에 의해 인증되도록 하는지 아니면 예외를 발생시키는지 설정합니다. `false`인 경우 드라이버는 모든 쓰기가 MongoDB 서버에 의해 인증되도록 하지 않습니다. 데이터 유형: `boolean` 기본값: `null` 연결 URI 예시: `safe=true`
journal	드라이버가 서버가 디스크의 저널 파일에 그룹 커밋할 때까지 기다릴지 여부를 설정합니다. 데이터 유형: `boolean` 기본값: `null` 연결 URI 예시: `journal=true`
w	설정되어 있으면 드라이버가 모든 쓰기 (write) 명령에 `{ w : wValue }` 을 추가합니다. 설정되어 있으면 `safe=True`을 의미합니다. 데이터 유형: `Integer` 또는 `String` 기본값: `null` 연결 URI 예시: `w=60`
wtimeoutMS (사용 중단됨)	이 옵션은 더 이상 사용되지 않습니다. 대신 클라이언트 수준 시간 제한을 설정하여이 시간 제한을 구성할 수 있습니다. 설정된 경우 드라이버는 모든 쓰기 명령에 `{ wtimeout : ms }` 를 추가합니다. 설정된 경우 을 `safe=true` 의미합니다. 이 옵션은 `w`와 함께 사용됩니다. 데이터 유형: `Integer` 기본값: `null` 연결 URI 예시: `wtimeoutMS=6000`

이 섹션의 연결 옵션에 대한 자세한 내용은 데이터베이스 및 컬렉션 가이드 를 참조하세요.

돌아가기

연결 대상 선택

데이터베이스 & collection