연결 대상 선택

이 페이지의 내용

개요

Atlas
로컬 배포
복제본 세트
API 문서

개요

이 가이드 에서는 연결 string 과 mongoc_client_t 객체 를 사용하여 다양한 유형의 MongoDB deployment에 연결하는 방법을 학습 수 있습니다.

Atlas

MongoDB 에서 deployment에 Atlas 연결하려면 연결 에 다음 요소를 string 포함하세요.

Atlas cluster 의 URL
MongoDB 사용자 이름
MongoDB 비밀번호

그런 다음 연결 문자열 을 mongoc_client_new() 함수에 전달합니다.

팁

Atlas 드라이버 연결 가이드 에 따라 연결 string 을 검색합니다.

다음 코드는 C 운전자 를 사용하여 Atlas cluster 에 연결하는 방법을 보여줍니다. 또한 이 코드는 mongoc_server_api_new() 함수를 사용하여 Stable API 버전을 지정합니다.

bson_t *ping = BCON_NEW ("ping", BCON_INT32 (1));
bson_t reply = BSON_INITIALIZER;
bson_error_t error;
mongoc_client_t *client = NULL;
// Create a new client 
client = mongoc_client_new ("mongodb+srv://<db_username>:<db_password>@<hostname:port>/?<options>");
// Set the version of the Stable API on the client
mongoc_server_api_t *api = mongoc_server_api_new(MONGOC_SERVER_API_V1);
if (!mongoc_client_set_server_api(client, api, &error)) {
  fprintf(stderr, "error: %s\n", error.message);
  goto cleanup;
}
// Send a ping to confirm a successful connection
if (!mongoc_client_command_simple (client, "admin", ping, NULL, &reply, &error)) {
  fprintf(stderr, "error: %s\n", error.message);
  goto cleanup;
}
printf ("Pinged your deployment. You successfully connected to MongoDB!\n");
cleanup:
  bson_destroy (&reply);
  bson_destroy (ping);
  mongoc_server_api_destroy (api);
  mongoc_client_destroy (client);

팁

Atlas 에 연결할 때 Stable API 클라이언트 옵션을 사용하여 Atlas 를 새 버전의 MongoDB Server 로 업그레이드할 때 호환성이 손상되는 변경을 방지하는 것이 좋습니다. Stable API 에 학습 보려면 Stable API 가이드 를 참조하세요.

로컬 배포

로컬 MongoDB deployment에 연결하려면 localhost 을 호스트 이름으로 사용합니다. 기본적으로 mongod 프로세스는 포트 27017 에서 실행되지만, 배포서버에 맞게 사용자 지정할 수 있습니다.

다음 코드는 C 운전자 를 사용하여 로컬 MongoDB deployment 에 연결하는 방법을 보여줍니다.

bson_t *ping = BCON_NEW ("ping", BCON_INT32 (1));
bson_t reply = BSON_INITIALIZER;
bson_error_t error;
mongoc_client_t *client = NULL;
// Create a new client 
mongoc_uri_t *uri = mongoc_uri_new_with_error ("mongodb://localhost:27017", &error);  
if (!uri) {
  fprintf (stderr, "failed to parse URI, error: %s\n", error.message);
  goto cleanup;
}
client = mongoc_client_new_from_uri (uri);
if (!client) {
  goto cleanup;
}
// Send a ping to confirm a successful connection
if (!mongoc_client_command_simple (client, "admin", ping, NULL, &reply, &error)) {
  fprintf(stderr, "error: %s\n", error.message);
  goto cleanup;
}
printf ("Pinged your deployment. You successfully connected to MongoDB!\n");
cleanup:
  bson_destroy (&reply);
  bson_destroy (ping);
  mongoc_client_destroy (client);
  mongoc_uri_destroy (uri);

복제본 세트

복제본 세트 세트 멤버의 호스트 이름(또는 IP 주소)과 포트 번호를 지정합니다.

복제본 세트에 있는 호스트의 전체 목록을 제공하는 대신 복제본 세트 복제본 세트 있는 호스트를 하나 이상 지정하고 C 운전자 가 자동 검색을 수행하여 다른 호스트를 찾도록 지시할 수 있습니다. 운전자 에 자동 검색을 수행하도록 지시하려면 다음 작업 중 하나를 수행합니다.

복제본 세트의 이름을 replicaSet 매개변수의 값으로 지정합니다.
directConnection 매개 변수의 값으로 false를 지정합니다.
복제본 세트에 둘 이상의 호스트를 지정합니다.

다음 예시 에서는 샘플 연결 URI를 사용하여 세 개의 서로 다른 호스트의 포트 27017 에서 실행 MongoDB 복제본 세트 myreplset 에 연결합니다.

bson_t *ping = BCON_NEW ("ping", BCON_INT32 (1));
bson_t reply = BSON_INITIALIZER;
bson_error_t error;
mongoc_client_t *client = NULL;
// Create a new client 
client = mongoc_client_new ("mongodb://host01:27017,host02:27017,host03:27017/?replicaSet=myreplset");
if (!client) {
  goto cleanup;
}
// Send a ping to confirm a successful connection
if (!mongoc_client_command_simple (client, "admin", ping, NULL, &reply, &error)) {
  fprintf(stderr, "error: %s\n", error.message);
  goto cleanup;
}
printf ("Pinged your deployment. You successfully connected to MongoDB!\n");
cleanup:
  bson_destroy (&reply);
  bson_destroy (ping);
  mongoc_client_destroy (client);

참고

mongoc_client_new() 함수는 비블로킹입니다. 복제본 세트 에 연결하면 클라이언트 가 배경 스레드를 사용하여 복제본 세트 에 연결하는 동안 생성자가 즉시 반환됩니다.

mongoc_client_t 객체 를 구성하고 해당 nodes 속성의 문자열 표현을 즉시 출력하는 경우 클라이언트 가 복제본 세트 멤버에 연결하는 동안 목록이 비어 있을 수 있습니다.

API 문서

이 가이드 에 언급된 객체 및 함수에 대한 자세한 내용은 다음 API 문서를 참조하세요.

돌아가기

Stable API

TLS 구성