Notas de versão

Visão geral

Descubra as novidades de cada versão:

• Versão 4.5.3

• Versão 4.5.2

• Versão 4.5.1

• Versão 4.5

• Versão 4.4

• Versão 4.3.1

• Versão 4.3

• Versão 4.2

• Versão 4.1

• Versão 4.0

• Versão 3.11

• Versão 3.10

• Versão 3.9

Novidades em 4.5.3

A versão do driver 4.5.3 inclui a seguinte alteração:

Para saber mais sobre esta versão, consulte as 45v..3 Notas de versão no GitHub.

Novidades em 4.5.2

A versão do driver 4.5.2 inclui as seguintes alterações:

To learn more about this release, see the v4.5.2 Release Notes on GitHub.

Novidades no 4.5.1

The 4.5.1 driver release includes the following change:

To learn more about this release, see the v4.5.1 Release Notes on GitHub.

Novidades no 4.5

A versão do driver 4.5 inclui o seguinte novo recurso:

• Adiciona o método append_metadata() às classes mongocxx::v1::client e mongocxx::v1::pool. Use este método para anexar metadados de handshake a um cliente ou pool depois de inicializá-lo. Isso é útil se seu projeto envolver o driver C++ e precisar se identificar para o MongoDB Server.

A versão inclui a seguinte remoção:

• Remover o suporte para o Visual Studio 2015, que atingiu o fim da vida útil em outubro de 2025. Para criar o driver C++ no Windows, use o Visual Studio 2017 versão 15.9 ou posterior.

To learn more about this release, see the v4.5.0 Release Notes on GitHub.

O que há de novo em 4.4

A versão do driver 4.4 inclui as seguintes novas funcionalidades:

• O ABI estável (v1) para as bibliotecas bsoncxx e mongocxx agora está pronto para produção. O soversion para ambas as bibliotecas agora está definido como 1.

• Adiciona suporte para operações de gravação em massa do cliente por meio da classe mongocxx::client_bulk_write. Ao contrário da gravação em massa no nível da coleção (mongocxx::bulk_write), a gravação em massa do cliente oferece suporte a gravações em várias coleções e pode agrupar inserções, atualizações e exclusões no mesmo payload de rede. Este recurso requer o MongoDB Server 8.0 ou posterior.

• Adiciona suporte para a opção readConcern às operações delete, insert, replace, bulkWrite, findOneAnd*, count e distinct.

• Adiciona suporte para o mecanismo de autenticação MONGODB-OIDC com Azure IMDS e Azure Functions/App Service Environment. Para saber mais, consulte autenticação OpenID Connect (OIDC).

A versão inclui a seguinte descontinuação:

• Substitui o suporte para o MongoDB Server.4.2 Para obter mais informações, consulte as Agendas do ciclo de vida do software MongoDB .

To learn more about this release, see the v4.4.0 Release Notes on GitHub.

Novidades em 4.3.1

A 4.3.1 versão do driver corrige o seguinte bug:

• Corrige uma regressão introduzida em 4.2.0 onde as operações findOneAnd* definem incorretamente upsert como true quando a opção foi explicitamente definida como false.

To learn more about this release, see the v4.3.1 Release Notes on GitHub.

Novidades no 4.3

A versão do driver 4.3 inclui as seguintes novas funcionalidades:

• Adiciona suporte para recursos de limitação de taxa de conexão de entrada. Você pode usar as opções enableOverloadRetargeting e maxAdaptiveRetries para melhorar o comportamento ao se conectar a servidores sobrecarregados. Esses recursos estarão disponíveis em clusters do Atlas executando o MongoDB 9.0 e posterior. Para saber mais sobre essas opções, consulte o guia Especificar opções de conexão.

A versão inclui a seguinte correção de bug:

• Adiciona operadores de subscritos ausentes para tipos de classe declarados em bsoncxx::vector::iterators.

A versão inclui a seguinte descontinuação:

• Descontinua o suporte para o Visual Studio 2015, que chegou ao fim da vida útil em 2025 de outubro. Use o Visual Studio 2017 ou posterior.

Para saber mais sobre esta versão, consulte as Notas de4 versão do3 v. no GitHub.

4.2: quais as novidades

A versão do driver 4.2 inclui as seguintes novas funcionalidades:

• Apresenta o driver C++ ABI estável (v1.0) para uso experimental. Como parte dessa mudança, grandes alterações interruptivas foram feitas na ABI instável. Quando você atualiza para v4.2 do driver, recomendamos migrar para usar a ABI estável em seu aplicativo.

• Exporta corretamente storage_engine() const em mongocxx::v_noabi::options::index usando macros de exportação mongocxx em vez de macros de exportação bsoncxx.

• Adiciona os assistentes de fluxo de alterações mongocxx::v1::change_stream::next() e mongocxx::v1::change_stream::try_next() para simplificar a iteração de fluxos de alterações.

• Adiciona suporte experimental para índices de texto de criptografia em execução através de mongocxx::v1::text_options.

• Remove o suporte para o MongoDB Server 4.2. Para obter mais informações, consulte as Agendas do ciclo de vida do software MongoDB.

• Remove o suporte para macOS 11 e macOS 12 (obsoleto na v4.1).

• Renomeia os arquivos de configuração do pacote CMake para usar o padrão <name>Config.cmake e <name>ConfigVersion.cmake, para obter consistência com o Driver MongoDB C 2.0.0 e mais recentes.

• Descontinua mongocxx::v_noabi::instance::current(). Recomendamos instanciar uma variável instance não global que seja válida para todas as operações mongocxx, conforme mostrado no código a seguir:

  int main() {
    mongocxx::instance instance;
    ...
  }

  Para implementações alternativas, consulte o Driver.4 2 Changelog no mongo-cxx-driver repositório do GitHub.

A versão inclui a seguinte correção de bug:

• Corrige um problema em que o driver lançava incorretamente uma exceção ao comparar um resultado mongocxx::result::insert_many com IDs que não fossem ObjectId.

To learn more about this release, see the v4.2 Release Notes on GitHub.

Novidades no 4.1

A versão do driver v4.1 inclui os seguintes novos recursos:

• Descontinua o método storage_options() para o método storage_engine() recém-adicionado em mongocxx::v_noabi::options::index

• Adiciona suporte para o tipo de vetor binário BSON.

  Para obter mais informações, consulte os seguintes recursos:

  • Tipos de BSON de dados binários no manual do MongoDB Server

  • exemplo de uso do vetor binário BSON no Github

• Corrige o bug da versão da API do driver C observado na versão4 v.0

• Adiciona uma alteração na opção padrão de configuração do ENABLE_TESTS que foi originalmente lançada para a versão4.0. Para obter mais informações, consulte a descrição da alteração interruptiva na página Atualização.

To learn more about this release, see the v4.1 Release Notes on GitHub.

4.0: quais as novidades

A versão do driver v4.0 inclui os seguintes novos recursos:

• Adiciona um método de getter para o campo start_at_operation_time de uma instância do mongocxx::options::change_stream.

A versão inclui o seguinte bug:

• O CMake pode definir incorretamente a versão da API de um driver C baixado automaticamente como 0.0.0 quando o projeto CMake é configurado mais de uma vez ou com o mesmo valor da versão da API do driver C++ quando BUILD_VERSION é explicitamente definido durante a configuração inicial. O CMake só fará o download automático do driver C com o driver C++ se não conseguir encontrar uma instalação de driver C existente usando find_package(). Esse bug será corrigido em uma futura versão de patch.

To learn more about this release, see the v4.0 Release Notes on GitHub.

Novidades no 3.11

A versão do driver v3.11 inclui os seguintes novos recursos:

• Adiciona suporte para MongoDB Server v8.0.

• Adiciona suporte para queries de intervalo de Queryable Encryption . Para usar esse recurso, seu aplicativo deve se conectar ao MongoDB Server 8.0 ou posterior. Para obter mais informações sobre Queryable Encryption, consulte Queryable Encryption no manual do MongoDB Server .

• Adiciona a função de membro empty() para mongocxx::v_noabi::bulk_write.

A versão inclui o seguinte bug:

• O CMake pode definir incorretamente a versão da API de um driver C baixado automaticamente como 0.0.0 quando o projeto CMake é configurado mais de uma vez ou com o mesmo valor da versão da API do driver C++ quando BUILD_VERSION é explicitamente definido durante a configuração inicial. O CMake só fará o download automático do driver C com o driver C++ se não conseguir encontrar uma instalação de driver C existente usando find_package(). Esse bug será corrigido em uma futura versão de patch.

To learn more about this release, see the v3.11 Release Notes on GitHub.

Novidades no 3.10

O v3.10.0 a versão do driver inclui as seguintes novas funcionalidades:

• Adiciona cabeçalhos de encaminhamento que fornecem declarações não definidoras de tipos de classe bsoncxx e mongocxx . O driver não é compatível com declarações de encaminhamento definidas pelo usuário de qualquer entidade de biblioteca. Para obter a declaração ou definição de uma entidade da biblioteca, inclua sempre o cabeçalho correspondente.

• A opção ENABLE_BSONCXX_USE_POLY_IMPLS do CMake permite selecionar bsoncxx implementações de polyfills17 C++ por padrão quando nenhuma biblioteca de polyfill é solicitada. Esta opção é OFF por padrão.

• A opção BSONCXX_POLY_USE_IMPLS do CMake permite selecionar implementações bsoncxx 1} de polyfills17 do C++ em vez de bibliotecas externas ou da biblioteca padrão do C++ . Esta opção é OFF por padrão.

• Os namespaces bsoncxx::v_noabi e mongocxx::v_noabi não são mais declarados embutidos. As declarações de namespace raiz ainda são suportadas e espera-se que permaneçam equivalentes às definições anteriores. Por exemplo, bsoncxx::document ainda é equivalente a bsoncxx::v_noabi::document e mongocxx::client ainda é equivalente a mongocxx::v_noabi::client.

• Por padrão, quando os nomes de arquivos da biblioteca são compilados com MSVC (conforme detectado pela variável MSVC do CMake), eles são incorporados a uma string de caracteres de tag ABI. Essas strings são semelhantes às seguintes:

  bsoncxx-v_noabi-rhs-x64-v142-md.lib

  Para desabilitar este comportamento, defina o ENABLE_ABI_TAG_IN_LIBRARY_FILENAMES=OFF como parte de sua configuração do CMake.

  A string da tag ABI também pode ser incorporada em nomes de arquivos de metadados pkg-config, semelhantes aos seguintes:

  libbsoncxx-v_noabi-rhs-x64-v142-md.pc

  Para habilitar este comportamento, defina ENABLE_ABI_TAG_IN_LIBRARY_FILENAMES=ON e ENABLE_ABI_TAG_IN_PKGCONFIG_FILENAMES=ON como parte de sua configuração do CMake.

To learn more about this release, see the v3.10 Release Notes on GitHub.

Novidades no 3.9

A versão do driver v3.9 inclui os seguintes novos recursos:

• A imagem do container do driver C++ agora está disponível no Docker Hub.

• O driver baixa automaticamente a dependência do driver MongoDB C se você não fornecer.

• O driver já não constrói testes como parte do alvo all . Para construir testes, defina o BUILD_TESTING=ON como parte da configuração do CMake.

• O driver usa o FetchContent módulo para baixar e construir a biblioteca de polyfill SNMLSTC Core, se não for fornecida pelo sistema, em vez do ExternalProject módulo. Ele também não corrige include diretivas em cabeçalhos MONMLSTC Core.

• Adiciona a opção CMake MONGOCXX_OVERRIDE_DEFAULT_INSTALL_PREFIX. Se essa opção estiver definida como TRUE, a opção CMAKE_INSTALL_PREFIX assumirá como padrão o diretório de construção. O valor padrão desta opção é TRUE.

• Adiciona uma API para gerenciar índices de pesquisa MongoDB.

• Adiciona o recurso VERSIONINFO a bsoncxx.dll e mongocxx.dll.

• Documenta explicitamente que lançar uma exceção de uma chamada de resposta de resposta APM é um comportamento indefinido.

• Não instala prematuramente cabeçalhos MONMLSTC Core durante a etapa de compilação do CMake.

• Requer que um pacote MongoDB C Driver CMake seja encontrado via find_dependency() para todas as configurações de pacote de driver C++ instaladas.

To learn more about this release, see the v3.9 Release Notes on GitHub.