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

MongoDB 클라이언트 만들기

이 페이지의 내용

  • 개요
  • 연결 URI
  • 만들기 mongocxx::client
  • API 문서

개요

MongoDB deployment에 연결하려면 다음 두 가지가 필요합니다.

  • 연결할 배포서버 를 운전자 에 알려주는 string 연결 이라고도 하는 연결 URI C++ MongoDB 입니다.

  • MongoDB deployment 에 대한 연결을 생성하고 해당 배포에서 작업을 수행할 수 있도록 하는 mongocxx:: 클라이언트 객체 입니다.

이러한 구성 요소 중 하나를 사용하여 MongoDB 에 연결된 동안 C++ 운전자 가 작동하는 방식을 사용자 지정할 수도 있습니다.

이 가이드에서는 연결 string 을 만들고 mongocxx::client 객체를 사용하여 MongoDB 에 연결하는 방법을 보여 줍니다.

참고

mongocxx:: 인스턴스

이 페이지의 코드 예제에서는 애플리케이션 의 다른 곳에서 mongocxx::instance 객체 를 이미 생성했다고 가정합니다.

인스턴스 생성에 학습 보려면 드라이버 인스턴스 생성을 참조하세요.

연결 URI

표준 연결 string 에는 다음 구성 요소가 포함됩니다.

구성 요소
설명

mongodb://

필수 사항입니다. 표준 연결 형식의 문자열로 식별하는 접두사입니다.

db_username:db_password

선택 사항. 인증 자격 증명. 이를 포함하면 클라이언트 는 authSource 에 지정된 데이터베이스 에 대해 사용자를 인증합니다. authSource 연결 옵션에 대한 자세한 내용은 인증 메커니즘을 참조하세요.

host[:port]

필수입니다. MongoDB가 실행 중인 호스트 및 선택적 포트 번호입니다. 포트 번호를 포함하지 않으면 드라이버는 기본 포트인 27017 을 사용합니다.

/defaultauthdb

선택 사항. 연결 string 에 db_username:db_password@ 인증 자격 증명이 포함되어 있지만 authSource 옵션이 없는 경우에 사용할 인증 데이터베이스입니다. 이 구성 요소를 포함하지 않으면 클라이언트는 admin 데이터베이스에 대해 사용자를 인증합니다.

?<options>

선택 사항. 연결별 옵션을 <name>=<value> 쌍으로 지정하는 쿼리 string 입니다. 이러한 옵션에 대한 전체 설명은 연결 옵션 지정 을 참조하세요.

연결 생성에 대한 자세한 string 내용은 MongoDB Server 설명서에서 연결 문자열 을 참조하세요.

만들기 mongocxx::client

MongoDB 에 대한 연결을 생성하려면 mongocxx::uri 클래스의 인스턴스 를 생성하고 연결 URI를 string 로 생성자에 전달합니다. 그런 다음 mongocxx::uri 클래스의 인스턴스 를 mongocxx::client 생성자에 전달합니다.

다음 예시 에서 운전자 는 샘플 연결 URI를 사용하여 localhost 의 포트 27017 에서 MongoDB deployment 에 연결합니다.

#include <mongocxx/instance.hpp>
#include <mongocxx/uri.hpp>
#include <mongocxx/client.hpp>
int main()
{
    mongocxx::instance instance;
    mongocxx::uri uri("mongodb://localhost:27017");
    mongocxx::client client(uri);
}

팁

클라이언트 재사용

각 mongocxx::client 객체 는 데이터베이스 에 대한 연결 풀을 나타내기 때문에 대부분의 애플리케이션은 여러 요청에 걸쳐 mongocxx::client 의 단일 인스턴스 만 필요로 합니다.

API 문서

C++ 운전자 에서 mongocxx::client 객체 를 만드는 방법에 학습 보려면 다음 API 설명서를 참조하세요.

돌아가기

드라이버 인스턴스 만들기

다음

연결 대상 선택