Docs Menu
Docs Home
/
언어
/
C++
/
C++ 드라이버
/
MongoDB에 연결

연결 옵션 지정

이 페이지의 내용

  • 개요
  • 연결 옵션 설정
  • 연결 URI 사용
  • mongocxx::options::client 객체 사용
  • 읽기 연결 옵션
  • 연결 URI 옵션
  • 복제본 세트 옵션
  • 연결 옵션
  • 연결 풀 옵션
  • 쓰기 고려 옵션
  • 읽기 고려 옵션
  • 읽기 기본 설정 옵션
  • 인증 옵션
  • 서버 선택/검색 옵션
  • 기타 구성

개요

이 페이지에서는 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

연결 옵션

TLS 옵션

연결 URI 옵션
mongocxx::uri 멤버

팁

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

타임아웃 옵션

연결 URI 옵션
mongocxx::uri 멤버

압축 옵션

연결 URI 옵션
mongocxx::uri 멤버

연결 풀 옵션

연결 URI 옵션
mongocxx::uri 멤버

쓰기 고려 옵션

연결 URI 옵션
mongocxx::uri 멤버
N/A
N/A

읽기 고려 옵션

연결 URI 옵션
mongocxx::uri 멤버

읽기 기본 설정 옵션

연결 URI 옵션
mongocxx::uri 멤버
N/A
N/A

인증 옵션

연결 URI 옵션
mongocxx::uri 멤버

서버 선택/검색 옵션

연결 URI 옵션
mongocxx::uri 멤버
N/A

기타 구성

연결 URI 옵션
mongocxx::uri 멤버
N/A

돌아가기

연결 대상 선택