/ /

연결 옵션

이 섹션에서는 .NET/C# 드라이버에서 사용할 수 있는 MongoDB 연결 및 인증 옵션에 대해 설명합니다. 연결 URI 또는 MongoClientSettings 객체를 사용하여 연결을 구성할 수 있습니다.

연결 URI 사용

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

using MongoDB.Driver;
// Sets the connection URI
const string connectionUri = "mongodb+srv://sample.host:27017/?connectTimeoutMS=60000&tls=true";
// Creates a new client and connects to the server
var client = new MongoClient(connectionUri);

사용 `MongoClientSettings`

MongoClientSettings 객체를 사용하여 연결 URI가 아닌 코드에서 연결 설정을 구성할 수 있습니다. 이러한 방식으로 연결을 구성하면 런타임에 설정을 더 쉽게 변경할 수 있고, 컴파일 중에 오류를 포착하는 데 도움이 되며, 연결 URI보다 더 많은 구성 옵션을 제공할 수 있습니다.

MongoClientSettings 객체를 사용하려면 클래스의 인스턴스를 만들고 속성을 설정한 다음 MongoClient 생성자에 인수로 전달하세요.

//const string connectionUri = "mongodb+srv://sample.host:27017/?connectTimeoutMS=60000&tls=true";
// Creates a MongoClientSettings object
var settings = new MongoClientSettings()
{
    Scheme = ConnectionStringScheme.MongoDBPlusSrv,
    Server = new MongoServerAddress("sample.host", 27017),
    ConnectTimeout = new TimeSpan(0, 0, 60),
    UseTls = true
};
// Creates a new client and connects to the server
var client = new MongoClient(settings);

연결 옵션

다음 표에는 MongoClientSettings 클래스에서 사용할 수 있는 각 연결 옵션과 가능한 경우 연결 문자열에서 동일한 결과를 얻는 방법이 나열되어 있습니다. MongoClientSettings 속성이 연결 문자열에서 둘 이상의 옵션에 매핑되는 경우 연결 URI 예시에는 모든 관련 옵션이 표시됩니다.

참고

특정 기간 동안 쿼리 매개변수를 사용하는 경우 값은 밀리초 단위여야 합니다. 예를 들어 60초를 지정하려면 60000 값을 사용합니다. 해당 시간 동안 MongoClientSettings 객체를 사용하는 경우 적절한 TimeSpan 값을 사용합니다.

MongoClientSettings 속성

설명

AllowInsecureTls

TLS 제한 조건을 최대한 완화할지 여부를 지정합니다. 이에는 유효하지 않은 인증서 또는 호스트 이름 불일치가 포함될 수 있습니다.

이 속성이 으로 설정되고 true 가 로 SslSettings.CheckCertificateRevocation
false설정되면 .NET/C# 드라이버에서 예외가 발생합니다.

데이터 유형: boolean
기본값: false
연결 URI 예시: tlsInsecure=true

애플리케이션 이름

연결 핸드신크의 일부로 드라이버가 클라이언트 메타데이터에서 서버에 전달하는 앱 이름입니다.
연결이 설정되면 서버가 MongoDB 로그에 이 값을 한 번 인쇄합니다.
이 값은 느린 쿼리 로그
및 프로필 컬렉션에도 기록됩니다.

데이터 유형: string
기본값: null
연결 URI 예시: appName=yourApp

자동 암호화 옵션

자동 클라이언트 사이드 암호화 위한 설정입니다.

데이터 유형: AutoEncryptionOptions
기본값: null
연결 URI 예시: N/A

클러스터 구성자

소켓, TLS, 클러스터 등에 대한 낮은 수준의 구성 옵션입니다.

데이터 유형: Action
기본값: null
연결 URI 예시: N/A

압축기

서버 와 주고받는 유선
프로토콜

메시지에 대한 기본 압축 유형(순서대로)입니다.운전자 서버 지원하는 이러한 압축 유형 중 첫 번째를 사용합니다. 데이터 유형: CompressorConfiguration
기본값: null
연결 URI 예시: compressors=snappy,zstd

ConnectTimeout

시간이 초과하기 전에 드라이버가 서버에 단일 TCP 소켓 연결을 설정하려고 시도하는 시간의 길이입니다.

데이터 유형: TimeSpan
기본값: 30 초
연결 URI 예시: connectTimeoutMS=0

자격 증명

운전자 서버 에 인증하는 방법에 대한 설정입니다. 여기에는
인증 자격 증명, 메커니즘, 소스 및 기타 설정이 포함됩니다.

SCRAM-SHA-1 SCRAM-SHA-256
인증 메커니즘 지정하지 않으면 운전자 서버 버전에 따라 또는 를 사용합니다. 사용 가능한
인증 메커니즘은 인증 메커니즘을 참조하세요.

데이터 유형: MongoCredential
기본값: null
연결 URI 예시:

mongodb://user1:password1&authMechanism=GSSAPI
&authMechanismProperties=SERVICE_NAME:other,REALM:otherrealm
&authSource=$external

DirectConnection

모든 작업을

호스팅하다 로
강제 디스패치할지

여부를 지정합니다. 이 옵션을 지정하면 운전자 DNS 시드 목록 연결 형식을 허용하지 않습니다. 대신 표준 연결 URI 형식을 사용해야 합니다.false
호스팅하다 이름을 두 개 이상 지정하는 경우 이 속성(으)로 설정하다 해야 합니다.

데이터 유형: boolean
기본값: false
연결 URI 예시: directConnection=true

HeartbeatInterval

정기적인 서버 모니터링 검사 간격.
500 밀리초 이상이어야 합니다.

데이터 유형: TimeSpan
기본값: 10 초
연결 URI 예시: heartbeatFrequencyMS=5000

HeartbeatTimeout

모니터링 소켓이 시간 초과되기 전에 유휴 상태를 유지할 수 있는 시간입니다.

데이터 유형: TimeSpan
기본값: ConnectTimeout과 동일한 값
연결 URI 예시: heartbeatTimeoutMS=5000

IPv6

호스팅하다 주소가 IPv6 형식인지 여부를 지정합니다.

데이터 유형: boolean
기본값: false
연결 URI 예시: ipv6=true

IsFrozen

설정이 고정되었는지 여부를 나타냅니다. 고정 설정은 변경할 수 없습니다.
이 옵션은 읽기 전용입니다.

데이터 유형: boolean
기본값: false
연결 URI 예시: N/A

LinqProvider

사용할 LINQ 제공자 .

데이터 유형: LinqProvider
기본값: LinqProvider.V3
연결 URI 예시: N/A

로드 밸런싱

드라이버가 로드 밸런서에 연결하는지 여부를 지정합니다. 다음의 경우에만 이 속성을 true 으로 설정할 수 있습니다.

호스트 이름을 하나만 지정합니다.
복제본 세트에 연결하지 않습니다.
SrvMaxHosts 속성을 사용하고 있지 않습니다.
DirectConnection 속성을 사용하고 있지 않습니다.

데이터 유형: boolean
기본값: false
연결 URI 예시: loadBalanced=true

LocalThreshold

서버 자격에 대한 지연 시간 창입니다. 서버의 왕복 시간이 가장 빠른
서버의 왕복 시간에 이 값을 더한 값보다 긴 경우, 해당 서버는
선택할 수 없습니다.

데이터 유형: TimeSpan
기본값: 15 밀리초
연결 URL 예시: localThresholdMS=0

로깅 설정

로깅에 사용되는 설정입니다.

데이터 유형: LoggingSettings
기본값: null
연결 URI 예시: N/A

MaxConnecting

드라이버의 연결 풀이
동시에 설정할 수 있는 최대 연결 수입니다.

데이터 유형: integer
기본값: 2
연결 URI 예시: maxConnecting=3

MaxConnectionIdleTime

드라이버가 연결을 닫기 전에 연결이 유휴 상태로 지속될 수 있는 시간입니다.

데이터 유형: TimeSpan
기본값: 10 분
연결 URI 예시: maxIdleTimeMS=300000

MaxConnectionLifeTime

연결이 만료되기 전에 풀링할 수 있는 시간입니다.

데이터 유형: TimeSpan
기본값: 30 분
연결 URI 예시: maxLifetimeMS=50000

최대 연결 풀 크기

드라이버가 연결 풀에서 생성할 수 있는 최대 클라이언트 또는 연결 수입니다.
이 카운트에는 사용 중인 연결이 포함됩니다.

데이터 유형: integer
기본값: 100
연결 URI 예시: maxPoolSize=150

최소 연결 풀 크기

작업이 발생하지 않는 경우에도 드라이버가 연결 풀에서 생성하고 유지해야 하는 연결 수입니다.
이 카운트에는
사용 중인 연결이 포함됩니다.

데이터 유형: integer
기본값: 0
연결 URI 예시: minPoolSize=1

readConcern

The client's default read concern.
See read concern for more information.

Data Type: ReadConcern
Default: ReadConcern.Default
Connection URI Example: readConcernLevel=local

ReadEncoding

string 역직렬화에 사용할 UTF-8 인코딩입니다.
유효하지 않은 UTF- 바이트 시퀴언스가 발견되면 엄격한 인코딩은8
예외를 발생시킵니다.

데이터 유형: UTF8Encoding
기본값: 엄격한 인코딩
연결 URI 예시: N/A

읽기 설정

클라이언트의 기본값 읽기 설정입니다. MaxStaleness 은
세컨더리 경험할 수 있고 여전히
서버 선택 대상이 될 수 있는 벽시계 시간으로 가장 긴 복제 지연 나타냅니다. 을 -1 지정하면 최대값이 없습니다. 자세한
내용은 읽기 설정 (read preference) 참조하세요.

데이터 유형: ReadPreference
기본값: ReadPreference.Primary
연결 URI 예시:

readPreference=primaryPreferred
&maxStalenessSeconds=90
&readPreferenceTags=dc:ny,rack:1

연결 URI에 readPreferenceTags 매개변수를 두 번 이상 포함할 수 있습니다. 이 경우 클라이언트는 각 인스턴스를 별도의 태그 세트로 취급합니다. URI에 있는 태그의 순서에 따라 읽기 설정 순서가 결정됩니다. 이 매개 변수는 읽기 설정 모드가 primary가 아닌 경우에만 사용할 수 있습니다.

복제본 세트 이름

연결할 복제본 세트의 이름입니다.

데이터 유형: string
기본값: null
연결 URI 예시: replicaSet=yourReplicaSet

읽기 재시도

재시도 가능 읽기를 활성화합니다.

데이터 유형: boolean
기본값: true
연결 URI 예시: retryReads=false

RetryWrites

재시도 가능 쓰기를 활성화합니다.

데이터 유형: boolean
기본값: true
연결 URI 예시: retryWrites=false

Scheme

표준 연결 문자열 형식()을 사용할지 아니면MongoDB
DNS 시드 목록 형식()을 사용할지MongoDBPlusSrv 지정합니다.

연결 문자열 형식에 대한 자세한 내용은 MongoDB 매뉴얼을 참조하세요.

DirectConnection 속성 로 설정하다 있고 true
DNS 시드 목록 형식을 사용하려고 하면 .NET/ C# 드라이버
예외가 발생합니다.

데이터 유형: ConnectionStringScheme
기본값: ConnectionStringScheme.MongoDB
연결 URI 예시: mongodb+srv://

서버

MongoDB 실행 호스팅하다 및 포트 번호입니다.

데이터 유형: MongoServerAddress
기본값: localhost:27017
연결 URI 예시: mongodb://sample.host:27017

서버API

Stable API 버전 관리를 선택할 수 있습니다.

Stable API 버전 관리에 대한 자세한 내용은 MongoDB 매뉴얼을 참조하세요.

데이터 유형: ServerApi
기본값: null
연결 URI 예시: N/A

ServerMonitoringMode

사용할 서버 모니터링 프로토콜 지정합니다.
이 옵션을 로 Auto 설정하다 하면 모니터링 모드 운전자 실행 환경에 따라
결정됩니다. 운전자 AWS Lambda 와
같은 FaaS(서비스로서의 기능) 환경에서 폴링 모드
사용하고 다른 환경에서는 스트리밍 모드 사용합니다.

데이터 유형: ServerMonitoringMode
기본값: Auto
연결 URI 예시: serverMonitoringMode=poll

서버

The cluster members where MongoDB is running.

Data Type: IEnumerable<MongoServerAddress>
Default: localhost:27017
Connection URI Example: mongodb://sample.host1:27017,sample.host2:27017

ServerSelectionTimeout

드라이버가 시간이 초과되기 전에 서버 선택을 시도하는 시간입니다.

데이터 유형: TimeSpan
기본값: 30 초
연결 URI 예시: serverSelectionTimeoutMS=15000

소켓 타임아웃

드라이버가 시간이
초과되기 전에 소켓에서 전송 또는 수신을 시도하는 시간의 길이입니다.

데이터 유형: TimeSpan
기본값: OS 기본값
연결 URI 예시: socketTimeoutMS=0

SRVmax 호스트

시드 목록을 초기화할 때 또는 SRV 폴맅 중 토폴로지에 새 호스트를 추가할 때 무작위로 선택할 수 있는 SRV 결과의 최대 개수입니다.

연결 문자열 스키마가(으)로 설정된 경우에만 이 속성을 사용할 수
ConnectionStringScheme.MongoDBPlusSrv있습니다. 복제본 세트에 연결할 때는 사용할 수 없습니다.

데이터 유형: integer
기본값: 0
연결 URI 예시: srvMaxHosts=3

SrvServiceName

The service name of the SRV resource records
that the driver retrieves to construct your seedlist. This
property overrides the default service name for SRV lookup in
discovery and polling.

You can use this property only if the connection-string scheme is set
to ConnectionStringScheme.MongoDBPlusSrv. You cannot use it when connecting
to a replica set.

Data Type: string
Default: "mongodb"
Connection URI Example: srvServiceName="customname"

SslSettings

클라이언트 인증서, 해지 처리, TLS/SSL 프로토콜 활성화 및 비활성화를 포함한
TLS/SSL 옵션. 가 로 설정하다

되고 SslSettings.CheckCertificateRevocation false
AllowInsecureTls가 로 설정하다 true 경우 .NET/ C# 드라이버
예외가 발생합니다.

데이터 유형: SslSettings
기본값: null
연결 URI 예시: tlsDisableCertificateRevocationCheck=false

UseTls

서버에 연결할 때 TLS를 요구할지 여부를 지정합니다.
"mongodb+srv" 의 스키마를 사용하거나 다른 TLS 옵션을
지정하면 이 옵션의 기본값은 true 이(가) 됩니다.

데이터 유형: boolean
기본값: false
연결 URI 예시: tls=true

대기열 시간 초과

운전자가 시간이
초과되기 전에 서버의 연결 풀에서 연결을 체크아웃하려고 시도하는 시간입니다.

데이터 유형: TimeSpan
기본값: 2 분
연결 URI 예시: waitQueueTimeoutMS=0

writeConcern

클라이언트 에 대한 쓰기 (write) 제한 시간 및 저널링을 포함한 기본값
쓰기 고려 설정입니다. 자세한 내용은
쓰기 고려 (write concern)참조하세요.

데이터 유형: WriteConcern
기본값: WriteConcern.Acknowledged
연결 URI 예시: w=majority&wTimeoutMS=0&journal=true

쓰기 인코딩

UTF-8 string 직렬화를 엄격하게 할지 관대하게 할지 지정합니다. 엄격한
인코딩을 사용하면 드라이버는 유효하지 않은
UTF-8 바이트 시큰스가 발견되면 예외를 발생시킵니다.

데이터 유형: UTF8Encoding
기본값: 엄격한 인코딩
연결 URI 예시: N/A

돌아가기

연결 가이드

TLS 구성

연결 옵션

연결 URI 사용

사용 MongoClientSettings

연결 옵션

사용 `MongoClientSettings`