Menu Docs

Driver do MongoDB C++

Bem-vindo ao site de documentação oficial do driver C++ do MongoDB.

Aprenda a instalar o driver, estabelecer uma conexão com o MongoDB e começar a trabalhar com dados no tutorial Introdução ao driver C++ .

Aprenda a criar e configurar uma conexão com uma implantação do MongoDB na seção Conectar ao MongoDB.

Saiba como você pode recuperar dados do MongoDB na seção Ler dados.

Saiba como você pode gravar dados no MongoDB na seção Gravar dados no MongoDB .

Saiba como usar o driver C++ para trabalhar com bancos de dados e coleções do MongoDB na seção Bancos de dados e coleções.

Saiba como trabalhar com tipos comuns de índices na seção Otimizar consultas com índices .

Aprenda a usar o driver C++ para realizar operações de agregação na seção Transformar seus dados com agregação.

Saiba mais sobre maneiras de autenticar seu aplicativo e criptografar seus dados na seção Proteger seus dados .

Saiba como trabalhar com formatos de dados especializados e tipos personalizados na seção Formatos de dados especializados .

Saiba mais sobre opções avançadas de configuração e instalação na seção Opções avançadas de configuração e instalação .

Para ver uma lista de novos recursos e alterações em cada versão, consulte a seção Novidades.

Saiba quais alterações você pode precisar fazer no seu aplicativo para atualizar as versões de drivers na seção Atualizar versões de drivers .

Saiba como relatar bugs, contribuir para o driver e encontrar ajuda na seção Problemas e ajuda .

Para tabelas de compatibilidade que mostram a versão recomendada do driver C++ para uso em versões específicas do C++ e do MongoDB Server, consulte a seção Compatibilidade.

Para obter informações detalhadas sobre tipos e métodos no driver C++, consulte a documentação da API do driver C++.

Importante

Recomendamos utilizar a biblioteca padrão C++ sempre que possível configurando a opção de configuração do CMAKE_CXX_STANDARD para 17 ou mais recente.

O Driver C++ do MongoDB usa os17 recursos std::optional<T> e do C++.std::string_view Se você configurar o driver com um padrão pré-C++17, a biblioteca bsoncxx fornecerá implementações de polyfill para esses recursos C++17. O driver usa as implementações de polyfill bsoncxx quando a opção de configuração CMAKE_CXX_STANDARD é definida como um número menor que 17. Por padrão, esta opção é definida como 11.

Aviso

A escolha da biblioteca polyfill tem um impacto direto na API pública e na ABI da biblioteca mongocxx. Alterar o polyfill pode levar a alterações significativas durante a compilação e alterações binárias durante a vinculação ou a execução. Para limitar a confiança no comportamento específico de polyfill, evite usar stdx::string_view e stdx::optional<T> com interfaces de biblioteca não bsoncxx e não mongocxx.

A estabilidade indica se este driver é recomendado para uso de produção. Atualmente, nenhum driver garante a estabilidade da API ou da ABI.

Para obter a documentação sobre versões anteriores, consulte a documentação antiga.

família/versão
Estabilidade
Desenvolvimento
Propósito

(ramificação mestre do repositório)

Instável

Desenvolvimento ativo

Desenvolvimento de novos recursos

mongocxx 4.0.x

estável

Somente correções de bugs

Versão atual do driver C++ estável

mongocxx 3.11.x

estável

Correções de bugs até novembro de 20}2025

Versão anterior do driver C++ estável

mongocxx 3.10.x

estável

none

Versão anterior do driver C++ estável

mongocxx 3.9.x

estável

none

Versão anterior do driver C++ estável

mongocxx 3.8.x

estável

none

Versão anterior do driver C++ estável

mongocxx 3.7.x

estável

none

Versão anterior do driver C++ estável

mongocxx 3.6.x

estável

none

Versão anterior do driver C++ estável

mongocxx 3.5.x

estável

none

Versão anterior do driver C++ estável

mongocxx 3.4.x

estável

none

Versão anterior do driver C++ estável

mongocxx 3.3.x

estável

none

Versão anterior do driver C++ estável

mongocxx 3.2.x

estável

none

Versão anterior do driver C++ estável

mongocxx 3.1.x

estável

none

Versão anterior do driver C++ estável

mongocxx 3.0.x

estável

none

Versão anterior do driver C++ estável |

O mongocxx é uma reescrita completa de um driver C++ para MongoDB baseado em libmongoc. Ele requer um compilador C++11 . Ele é conhecido por basear-se nas arquiteturas x86 e x86-64 para Linux, macOS, Windows e Openbsd.

A biblioteca do driver mongocxx inclui um pacote bson correspondente, bsoncxx, que implementa a especificação BSON. Essa biblioteca pode ser usada de modo autônomo para serialização e desserialização de objetos, mesmo quando não se está usando o MongoDB.

As versões do driver mongocxx têm números de versão como v3.xy

Observação

Não havia drivers v2.xy C++ para evitar confusão com os drivers legados obsoletos-0.0-26compatíveis-2.xy.

Os drivers do MongoDB C++ estão disponíveis sob os termos da Licença Apache, versão 2.0.