MongoDB 클라이언트 만들기
이 페이지의 내용
개요
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 에 연결합니다.
int main() { mongocxx::instance instance; mongocxx::uri uri("mongodb://localhost:27017"); mongocxx::client client(uri); }
팁
클라이언트 재사용
각 mongocxx::client 객체 는 데이터베이스 에 대한 연결 풀을 나타내기 때문에 대부분의 애플리케이션은 여러 요청에 걸쳐 mongocxx::client 의 단일 인스턴스 만 필요로 합니다.
API 문서
C++ 운전자 에서 mongocxx::client 객체 를 만드는 방법에 학습 보려면 다음 API 설명서를 참조하세요.