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.
Operações CRUD
Saiba como recuperar e gravar dados do MongoDB na seção Operações CRUD.
Transforme seus dados com agregação
Saiba como usar o driver C++ para executar operações de agregação na seção Agregação.
Formatos de dados especializados
Saiba como trabalhar com formatos de dados especializados e tipos personalizados na seção Formatos de dados especializados .
Otimizar queries com índices
Aprenda a trabalhar com tipos comuns de índices na seção Índices.
Proteja seus dados
Aprenda sobre diferentes maneiras de autenticar seu aplicativo e criptografar seus dados na seção Segurança.
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 .
Incluir e vincular o driver em seu programa
Saiba como incluir e vincular o driver em seu programa na seção Incluir e vincular o driver em seu programa.
Notas de versão
Para obter uma lista de novos recursos e alterações em cada versão, consulte a seção Notas de versão.
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
Para obter tabelas de compatibilidade que mostram a versão recomendada do driver C++ a ser usado para versões específicas do C++ MongoDB Server, consulte 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 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.
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 legada.
família/versão | Estabilidade | Desenvolvimento | Propósito |
|---|---|---|---|
(ramificação mestre do repositório) | Instável | Desenvolvimento ativo | Desenvolvimento de novos recursos |
mongocxx 4.2.x | estável | Somente correções de bugs | Versão atual do driver C++ estável |
mongocxx 4.1.x | estável | none | Versão anterior do driver C++ estável |
mongocxx 4.0.x | estável | none | Versão anterior do driver C++ estável |
mongocxx 3.11.x | estável | none | 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
Pede ajuda na página do MongoDB Stack Overflow ou na comunidade do MongoDB Reddit.
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.