Comece com o Driver C

Visão geral

O MongoDB C Driver é uma biblioteca C que você pode usar para se conectar ao MongoDB e interagir com dados armazenados em seu sistema. Este guia mostra como criar um aplicação que usa o driver C para se conectar a um cluster MongoDB hospedado no MongoDB Atlas e consultar dados em seu cluster.

Siga este guia para conectar um aplicação C de amostra a uma implantação do MongoDB Atlas . Se você preferir se conectar ao MongoDB usando um driver ou uma linguagem de programação diferente, consulte nossa lista de drivers oficiais.

Baixar e instalar

sudo dnf info mongo-c-driver-devel

apt-cache policy libmongoc-dev

yum install epel-release

yum install mongo-c-driver-devel

yum install mongo-c-driver

dnf install mongo-c-driver-devel

apt install libmongoc-dev

apt install libmongoc-1.0-0

{
   // ...
   "dependencies": [
     // ...
     "mongo-c-driver"
   ]
}

vcpkg install mongo-c-driver

find_package(mongoc-1.0 CONFIG REQUIRED)
target_link_libraries(my-application
    PRIVATE $<IF:$<TARGET_EXISTS:mongo::mongoc_shared>,mongo::mongoc_shared,mongo::mongoc_static>)

cmake -S . -B _build -D
CMAKE_TOOLCHAIN_FILE=$VCPKG_ROOT/scripts/buildsystems/vcpkg.cmake

brew install mongo-c-driver

Criar uma MongoDB deployment

Você pode criar uma implantação MongoDB de camada gratuita no MongoDB Atlas para armazenar e gerenciar seus dados. O MongoDB Atlas hospeda e gerencia seu banco de dados MongoDB na nuvem.

Após concluir estas etapas, você terá uma nova implantação de camada grátis do MongoDB no Atlas, credenciais de trigger de banco de dados e dados de exemplo carregados no seu reconhecimento de data center.

Criar uma connection string

Você pode se conectar à sua implantação do MongoDB fornecendo um URI de conexão, também chamado de connection string, que instrui o driver sobre como se conectar a uma implantação do MongoDB e como se comportar enquanto estiver conectado.

A cadeia de conexão inclui o nome do host ou endereço IP e porta de sua implantação, o mecanismo de autenticação, as credenciais do usuário quando aplicável, e opções de conexão.

Para se conectar a uma instância ou sistema não hospedado no Atlas, consulte o guia Escolher um Destino de Conexão .

1

Encontre sua connection string do MongoDB Atlas

Para recuperar a string de conexão da implantação criada na etapa anterior, faça login na sua conta do Atlas e navegue até a seção Database e clique no botão Connect para a nova implantação.

Vá para a seção Connect your application e selecione "C" no menu de seleção Driver e a versão que melhor corresponde à versão instalada no menu de seleção Version.

Selecione o mecanismo de autenticação Password (SCRAM).

Desmarque a opção Include full driver code example para visualizar somente a string de conexão.

2

Copie a connection string

Clique no botão à direita da string de conexão para copiá-la para a área de transferência, como mostrado na seguinte captura de tela:

3

Atualizar os espaços reservados

Cole esta connection string em um arquivo no editor de texto de sua preferência e substitua os placeholders <db_username> e <db_password> pelo seu nome de usuário e senha de utilizador de banco de dados.

Salve este arquivo em um local seguro para uso na próxima etapa.

Após concluir estas etapas, você tem uma string de conexão que corresponde ao seu agrupamento do Atlas .

Executar uma query de amostra

Você pode criar um aplicação que se conecta à sua implementação do MongoDB e recupera dados da coleção movies no banco de dados sample_mflix .

Para saber mais sobre o banco de dados do sample_mflix, consulte Amostra de conjunto de dados Mflix na documentação do Atlas.

mkdir c-quickstart

cd c-quickstart
touch quickstart.c

cd c-quickstart
type nul > quickstart.c

#include <bson/bson.h>
#include <mongoc/mongoc.h>
#include <stdio.h>
int
main (void)
{
    const bson_t *doc;
    mongoc_init ();
    mongoc_client_t *client = mongoc_client_new ("<connection string>");
    mongoc_collection_t *collection = mongoc_client_get_collection (client, "sample_mflix", "movies");
    // Specify the query filter
    bson_t *query = BCON_NEW ("title", "The Shawshank Redemption");
    mongoc_cursor_t *results = mongoc_collection_find_with_opts (collection, query, NULL, NULL);
    // Print the results
    while (mongoc_cursor_next (results, &doc))
    {
        char* str = bson_as_canonical_extended_json (doc, NULL);
        printf ("%s\n", str);
        bson_free (str);
    }
    bson_destroy (query);
    mongoc_cursor_destroy (results);
    mongoc_collection_destroy (collection);
    mongoc_client_destroy (client);
    mongoc_cleanup ();
    return EXIT_SUCCESS;
}

gcc -o quickstartc quickstart.c $(pkg-config --libs --cflags libmongoc-1.0)
./quickstartc

{ "_id" : { "$oid" : "..." },
"plot" : "Two imprisoned men bond over a number of years, finding solace
and eventual redemption through acts of common decency.",
...
"title" : "The Shawshank Redemption",
...

Depois de concluir essas etapas, você tem um aplicativo funcional que utiliza o driver para se conectar à sua implantação do MongoDB, executar uma consulta nos dados de amostra e imprimir o resultado.

Próximos passos

Parabéns por concluir o tutorial de início rápido!

Neste tutorial, você criou um aplicação C que se conecta a um sistema MongoDB hospedado no MongoDB Atlas e recupera um documento que corresponde a uma query.

Saiba mais sobre o driver C nos seguintes recursos:

• Saiba como realizar operações de leitura na seção Ler dados.

• Saiba como realizar operações de gravação na seção Gravar dados no MongoDB .