Driver do MongoDB C++
Visão geral
Bem-vindo ao site de documentação oficial do driver C++ do MongoDB.
Começar
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++ .
Conecte-se ao MongoDB
Aprenda a criar e configurar uma conexão com uma implantação do MongoDB na seção Conectar ao MongoDB.
Ler dados do MongoDB
Saiba como você pode recuperar dados do MongoDB na seção Ler dados do MongoDB .
Gravar dados no MongoDB
Saiba como você pode gravar dados no MongoDB na seção Gravar dados no MongoDB .
Bancos de dados e coleções
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.
Otimizar queries com índices
Saiba como trabalhar com tipos comuns de índices na seção Otimizar consultas com índices .
Transforme seus dados com agregação
Aprenda a usar o driver C++ para realizar operações de agregação na seção Transformar seus dados com agregação.
Proteja seus dados
Saiba mais sobre maneiras de autenticar seu aplicativo e criptografar seus dados na seção Proteger seus dados .
Formatos de dados especializados
Saiba como trabalhar com formatos de dados especializados e tipos personalizados na seção Formatos de dados especializados .
Opções avançadas de instalação
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 .
NOVIDADES
Para ver uma lista de novos recursos e alterações em cada versão, consulte a seção Novidades.
Atualizar versões do driver
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 .
Problemas e ajuda
Saiba como relatar bugs, contribuir para o driver e encontrar ajuda na seção Problemas e ajuda .
Compatibilidade
Documentação da API
Para obter informações detalhadas sobre tipos e métodos no driver C++, consulte a documentação da API do driver C++.
Configuração de polyfill C++17
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 C++17 recursos std::optional<T>
e 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 está configurada para 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.
Status do driver por família e versão
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 | |
Driver atual
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.
Como obter ajuda
Faça perguntas em nossos fóruns da MongoDB Community.
Visite nossos Canais de Suporte.
Veja como relatar um erro.
Licença
Os drivers do MongoDB C++ estão disponíveis sob os termos da Licença Apache, versão 2.0.