/ /

Java Reactive Streams 드라이버

Java Reactive Streams 드라이버

연결

연결 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	네트워크 오류로 인해 지원되는 쓰기 작업이 실패한 경우 운전자 지원되는 쓰기 (write) 작업을 다시 시도할지 여부를 설정합니다. 데이터 유형: `boolean` 기본값: `True` 연결 URI 예시: `retryWrites=true`
retryReads	네트워크 오류로 인해 운전자 지원되는 읽기 작업을 재시도하지 못할 경우 다시 시도할지 여부를 설정합니다. 데이터 유형: `boolean` 기본값: `True` 연결 URI 예시: `retryReads=true`
uuidRepresentation	Java Reactive Streams 운전자 UUID 인스턴스를 인코딩하는 데 사용하는 메커니즘을 설정합니다. 유효한 모든 옵션 목록은 Uuid 표현 API 문서를 참조하세요. 데이터 유형: `String` 기본값: `unspecified` 연결 URI 예시: `uuidRepresentation=unspecified`

프록시 구성

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

읽기 설정 구성

연결 옵션	설명
읽기 설정	이 연결에 대한 읽기 설정 (read preference) 설정합니다. 열거된 `primary` 값은,,, `primaryPreferred` `secondarysecondaryPreferred`및 `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	설정하다 경우 운전자 `{ w : wValue }` 모든 쓰기 (write) 명령에 를 추가합니다. 설정하다 경우 `safe=True`을(를) 의미합니다. 데이터 유형: `Integer` 또는 `String` 기본값: `null` 연결 URI 예시: `w=60`
wtimeoutMS (사용 중단됨)	이 옵션은 더 이상 사용되지 않습니다. 대신 클라이언트 수준 시간 제한을 설정하여 이 시간 제한을 구성할 수 있습니다. 설정하다 경우 운전자 `{ wtimeout : ms }` 모든 쓰기 (write) 명령에 를 추가합니다. 설정하다 경우 을(를) `safe=true` 의미합니다. 이 옵션은 `w` 와 함께 사용됩니다. 데이터 유형: `Integer` 기본값: `null` 연결 URI 예시: `wtimeoutMS=6000`

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

돌아가기

연결 대상 선택

데이터베이스 & collection