/ /

연결 옵션 지정

개요

이 페이지에서는 C++ 운전자 에서 사용할 수 있는 MongoDB 연결 및 인증 옵션에 대해 설명합니다.

연결 옵션 설정

연결 URI에 옵션을 지정하거나 mongocxx::options::client 클래스의 인스턴스 를 client_options 매개 변수로 mongocxx::client 생성자에 전달하여 연결을 구성할 수 있습니다.

참고

일부 연결 옵션은 연결 URI에서만 지정할 수 있고, 다른 옵션은 client_options 매개변수에서만 지정할 수 있습니다. You might need to combine these methods to specify all the options that you need.

연결 URI 사용

mongocxx::client 객체 를 구성할 때 연결 URI를 나타내는 mongocxx::uri 객체 를 전달할 수 있습니다. 이 연결 URI에는 연결 옵션을 <name>=<value> 쌍으로 포함할 수 있습니다. 다음 예시 에서 연결 URI에는 값이 true 인 tls 옵션과 값이 path/to/file.pem 인 tlsCertificateKeyFile 옵션이 포함되어 있습니다.

#include <mongocxx/uri.hpp>
#include <mongocxx/client.hpp>
#include <mongocxx/instance.hpp>
int main()
{
    mongocxx::instance instance;
    mongocxx::uri uri("mongodb://<hostname>:<port>/?tls=true&tlsCertificateKeyFile=path/to/file.pem");
    mongocxx::client client(uri);
}

`mongocxx::options::client` 객체 사용

mongocxx::client 생성자에는 mongocxx::options::client 클래스의 인스턴스 를 허용하는 client_options 매개 변수가 포함되어 있습니다. 연결 URI에 특정 옵션을 포함하는 대신 client_options 매개변수에 특정 옵션을 지정할 수 있습니다.

다음 예시 에서는 client_options 매개 변수를 사용하여 연결 옵션을 설정하다 하는 방법을 보여 줍니다.

#include <mongocxx/uri.hpp>
#include <mongocxx/client.hpp>
#include <mongocxx/instance.hpp>
int main()
{
    mongocxx::instance instance;
    mongocxx::options::client client_options;
    mongocxx::options::tls tls_options;
    tls_options.pem_file("/path/to/file.pem");
    client_options.tls_opts(tls_options);
    mongocxx::uri uri("mongodb://<hostname>:<port>/?tls=true");
    mongocxx::client client(uri, client_options);
}

읽기 연결 옵션

mongocxx::client 객체 를 생성한 후 mongocxx::uri 객체 의 속성을 사용하여 특정 연결 옵션의 값을 읽을 수 있습니다.

다음 예시 에서는 tls() 속성 을 사용하여 tls 연결 옵션의 값을 읽는 방법을 보여 줍니다.

#include <mongocxx/uri.hpp>
#include <mongocxx/client.hpp>
#include <mongocxx/instance.hpp>
int main()
{
    mongocxx::instance instance;
    mongocxx::uri uri("mongodb://<hostname>:<port>/?tls=true");
    mongocxx::client client(uri);
    auto is_tls_enabled = uri.tls();
}

다음 섹션에서는 이를 지원하는 각 연결 옵션에 해당하는 mongocxx::uri 속성 을 보여줍니다.

연결 URI 옵션

다음 섹션에서는 C++ 운전자 에 전달된 연결 URI에서 설정하다 수 있는 연결 옵션에 대해 설명합니다. 각 연결 옵션은 MongoDB Server 매뉴얼 및 지원되는 경우 해당 mongocxx::uri 속성 에 연결됩니다.

복제본 세트 옵션

연결 URI 옵션	`mongocxx::uri` 멤버
directConnection	direct_connection()
복제본 세트	replica_set()

연결 옵션

TLS 옵션

연결 URI 옵션	`mongocxx::uri` 멤버
TLS	tls()
tlsCertificateKeyFile	tls_certificate_key_file()
tlsCertificateKeyFilePassword	tls_certificate_key_file_password()
tlsCAFile	tls_ca_file()
tlsAllowInvalidCertificates	tls_allow_invalid_certificates()
tlsAllowInvalidHostnames	tls_allow_invalid_hostnames()
tlsInsecure	tls_insecure()
tlsDisableCertificateReventionCheck	tls_disable_certificate_revention_check()
tlsDisableOCSPEndpointCheck	tls_disable_ocsp_endpoint_check()

팁

대부분의 TLS 옵션은 client_options 매개변수를 사용하여 설정하다 수 있습니다. 자세한 내용은 mongocxx::options::tls API 문서를 참조하세요.

타임아웃 옵션

연결 URI 옵션	`mongocxx::uri` 멤버
connectTimeoutMS	connect_timeout_ms()
socketTimeoutMS	socket_timeout_ms()

압축 옵션

연결 URI 옵션	`mongocxx::uri` 멤버
압축기	Compressor()
zlibCompressionLevel	zlib_compression_level()

연결 풀 옵션

연결 URI 옵션	`mongocxx::uri` 멤버
maxPoolSize	max_pool_size()
waitQueueTimeoutMS	wait_queue_timeout_ms()

쓰기 고려 옵션

연결 URI 옵션	`mongocxx::uri` 멤버
w	write_concern()
wTimeoutMS	N/A
journal	N/A

읽기 고려 옵션

연결 URI 옵션	`mongocxx::uri` 멤버
readConcernLevel	read_concern()

읽기 기본 설정 옵션

연결 URI 옵션	`mongocxx::uri` 멤버
읽기 설정	read_preference()
최대 보관 기간	N/A
readPreferenceTags	N/A

인증 옵션

연결 URI 옵션	`mongocxx::uri` 멤버
authMechanism	auth_mechanism()
authMechanismProperties	auth_mechanism_properties()
authSource	auth_source()

서버 선택/검색 옵션

연결 URI 옵션	`mongocxx::uri` 멤버
localThresholdMS	local_threshold_ms()
serverSelectionTimeoutMS	server_selection_timeout_ms()
서버 선택 시도	server_selection_try_once()
heartbeatFrequencyMS	heartbeat_ Frequency_ms()
socketCheckIntervalMS	N/A

기타 구성

연결 URI 옵션	`mongocxx::uri` 멤버
앱 이름	appname()
retryReads	retry_reads()
retryWrites	retry_writes()
loadBalanced	N/A
srvMaxHosts	srv_max_hosts()

돌아가기

연결 대상 선택

TLS 구성

개요

연결 옵션 설정

참고

연결 URI 사용

mongocxx::options::client 객체 사용

읽기 연결 옵션

연결 URI 옵션

복제본 세트 옵션

연결 옵션

TLS 옵션

팁

타임아웃 옵션

압축 옵션

연결 풀 옵션

쓰기 고려 옵션

읽기 고려 옵션

읽기 기본 설정 옵션

인증 옵션

서버 선택/검색 옵션

기타 구성

`mongocxx::options::client` 객체 사용