데이터베이스 및 컬렉션

개요

이 가이드 에서는 C++ 운전자 사용하여 MongoDB 데이터베이스 및 컬렉션과 상호 작용 방법을 학습 수 있습니다.

MongoDB는 데이터를 다음 수준의 계층 구조로 구성합니다.

• 데이터베이스: 컬렉션을 저장 하는 MongoDB deployment 의 최상위 데이터 구조입니다.

• 컬렉션: MongoDB 문서 그룹입니다. 관계형 데이터베이스의 테이블과 유사합니다.

• Documents: Units that store literal data such as string, numbers, dates, and other embedded documents. For more information about document field types and structure, see the Documents guide in the MongoDB Server manual.

데이터베이스에 액세스

mongocxx::client 객체 에서 database() 함수를 호출하고 데이터베이스 이름을 인수로 전달하여 데이터베이스 액세스 할 수 있습니다.

다음 예제에서는 test_database 데이터베이스에 액세스합니다.

auto db = client.database("test_database");

또는 다음 코드와 같이 mongocxx::client 에 [] 연산자 database() 함수의 약어로 사용할 수 있습니다.

auto db = client["test_database"];

컬렉션에 액세스

mongocxx::database 객체 에서 collection() 함수를 호출하고 컬렉션 이름을 인수로 전달하여 컬렉션 액세스 할 수 있습니다.

다음 예시 test_collection이라는 컬렉션 에 액세스합니다.

auto coll = database.collection("test_collection");

또는 다음 코드와 같이 mongocxx::database 에 [] 연산자 collection() 함수의 약어로 사용할 수 있습니다.

auto coll = database["test_collection"];

컬렉션 생성

create_collection() 함수를 사용하여 MongoDB database 에 컬렉션 명시적으로 만들 수 있습니다.

다음 예에서는 example_collection 이라는 collection을 만듭니다.

auto coll = database.create_collection("example_collection");

BSON 문서 내에서 create_collection() 함수의 두 번째 매개변수로 전달하여 최대 크기 및 문서 유효성 검사 규칙과 같은 컬렉션 옵션을 지정할 수 있습니다. 선택적 매개변수의 전체 목록은 MongoDB Server 매뉴얼의 create 명령 문서를 참조하세요.

컬렉션 목록 가져오기

list_collections() 함수를 호출하여 데이터베이스 의 컬렉션 목록을 조회 할 수 있습니다. 이 함수는 데이터베이스 의 모든 컬렉션과 관련 메타데이터 포함된 커서 반환합니다.

다음 예시 list_collections() 함수를 호출하고 커서 반복하여 결과를 인쇄합니다.

auto cursor = database.list_collections();
for(auto&& doc : cursor) {
    std::cout << bsoncxx::to_json(doc) << std::endl;
}

Collection: { "name" : "test_collection", "type" : "collection", ...}
Collection: { "name" : "example_collection", "type" : "collection", ... }

데이터베이스 에서 컬렉션 이름만 쿼리 하려면 다음 예시 와 같이 list_collection_names() 함수를 호출합니다.

auto list = database.list_collection_names();
for(auto&& name : list) {
    std::cout << name << std::endl;
}

test_collection
example_collection

커서 반복에 대한 자세한 내용은 커서에서 데이터 액세스 가이드 참조하세요.

컬렉션 삭제

drop() 함수를 사용하여 데이터베이스 에서 컬렉션 삭제 수 있습니다.

다음 예시에서는 test_collection 컬렉션을 삭제합니다.

auto coll = database["test_collection"];
coll.drop();

데이터베이스 삭제

drop() 함수를 사용하여 클러스터 에서 데이터베이스 삭제 수 있습니다.

다음 예시 test_database 데이터베이스 삭제합니다.

auto db = client["test_database"];
db.drop();

읽기 및 쓰기 작업 구성

읽기 설정( read preference)을 설정하여 드라이버가 읽기 작업을 라우팅하는 방법을 제어할 수 있습니다. 또한 읽기 고려 및 쓰기 고려를 설정하여 드라이버가 복제본 세트에 대한 읽기 및 쓰기 작업의 승인을 기다리는 방법에 대한 옵션을 제어할 수도 있습니다.

기본값 으로 데이터베이스는 mongocxx::client 객체 에서 이러한 설정을 상속하고 컬렉션은 데이터베이스 에서 설정을 상속합니다. 그러나 데이터베이스 또는 컬렉션 에서 다음 함수 중 하나를 사용하여 이러한 설정을 변경할 수 있습니다.

• read_preference()

• read_concern()

• write_concern()

읽기 및 쓰기 (write) 설정에 대해 자세히 학습 MongoDB Server 매뉴얼에서 다음 가이드를 참조하세요.

• 읽기 설정

• readConcern

• 쓰기 고려

auto db = client["test_database"];
mongocxx::read_preference rp;
rp.mode(mongocxx::read_preference::read_mode::k_secondary);
mongocxx::read_concern rc;
rc.acknowledge_level(mongocxx::read_concern::level::k_majority);
db.read_preference(rp);
db.read_concern(rc);

auto coll = client["test_database"]["test_collection"];
mongocxx::read_concern rc;
rc.acknowledge_level(mongocxx::read_concern::level::k_local);
mongocxx::write_concern wc;
wc.acknowledge_level(mongocxx::write_concern::level::k_acknowledged);
coll.read_concern(rc);
coll.write_concern(wc);

auto tag_set_ny = make_document(kvp("dc", "ny"));
auto tag_set_sf = make_document(kvp("dc", "sf"));
mongocxx::read_preference rp;
rp.mode(mongocxx::read_preference::read_mode::k_secondary);
rp.tags(make_array(tag_set_ny, tag_set_sf).view());

mongocxx::uri uri("mongodb://localhost:27017/?localThresholdMS=35");
mongocxx::client client(uri);

API 문서

이 가이드 에서 설명하는 함수에 대해 자세히 학습 다음 API 문서를 참조하세요.

• database()

• collection()

• create_collection()

• list_collections()

• list_collection_names()

• Drop()

• read_preference()

• read_concern()

• write_concern()