Notas de versão

Visão geral

Descubra as novidades de cada versão:

• Versão 4.6.2

• Versão 4.6.1

• Versão 4.6

• 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.6.2

O 4.6.2 versões dos drivers inclui as seguintes correções:

• Corrige referências pendentes incondicionalmente retornadas pelos acessadores get_<type>() para bsoncxx::v_noabi::types::bson_value::value. O tipo de retorno de referência T const& inutilizável é substituído por um tipo de retorno por valor T para satisfazer o comportamento documentado da API.

• Corrige um problema em que valores de tipo BSON semelhantes a string vazia eram convertidos incorretamente em strings nulas na API v_noabi quando acessados como uma instância types::view ou types::value, como por meio de métodos element::get_*(). Isso afetou os BSON types string, symbol, code, regex, dbpointer e codewscope. A API v1 não foi afetada, porque uma string vazia lá é sempre representada como uma visualização de string inicializada por padrão.

• Corrige o comportamento indefinido na API v1, que ocorria ao copiar ou atribuir uma instância v1::types::value que envolvia um valor de tipo BSON semelhante a uma string nula. Isso afetou os BSON types string, symbol, code, dbpointer e codewscope. Valores semelhantes a strings não vazios não foram afetados.

O 4.6.2 versões dos drivers também inclui a seguinte alteração:

• Aumenta a versão mínima exigida do driver C para 2.5.8.

Para saber mais sobre esta versão, consulte as Notas da versão v4.6.2 no GitHub.

Novidades em 4.6.1

Para saber mais sobre esta versão, consulte as Notas da versão v4.6.1 no GitHub.

4.6: quais as novidades

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

• Adiciona a API de string de criptografia em execução, que substitui a API de texto experimental e inclui as seguintes alterações:

  • Adiciona a classe mongocxx::v1::string_options e seu alias mongocxx::string_options.

  • Adiciona o método string_opts() às classes mongocxx::v1::encrypt_options e mongocxx::options::encrypt, que define o campo string_opts. Se você definir os campos text_opts e string_opts, o driver usará apenas o campo string_opts.

  • Adiciona o enumerador k_string à enumeração mongocxx::v1::encrypt_options::encryption_algorithm.

  • Adiciona os enumeradores k_prefix, k_suffix e k_substring à enumeração mongocxx::v1::encrypt_options::encryption_query_type.

• Expõe o parâmetro atClusterTime em sessões de snapshot.

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

• Descontinua a API de texto de criptografia em execução em favor da API de string descrita na lista anterior. As seguintes classes, métodos e enumeradores permanecem documentados como experimentais e podem ser removidos em uma versão futura:

  • A classe mongocxx::v1::text_options e seus aliases mongocxx::text_options e mongocxx::options::text.

  • O método text_opts() nas classes mongocxx::v1::encrypt_options e mongocxx::options::encrypt.

  • O enumerador k_textPreview na enumeração mongocxx::v1::encrypt_options::encryption_algorithm.

  • Os enumeradores k_prefixPreview, k_suffixPreview e k_substringPreview na enumeração mongocxx::v1::encrypt_options::encryption_query_type.

Para saber mais sobre esta versão, consulte as Notas da versão v4.6.0 no GitHub.

Novidades em 4.5.3

O 4.5.3 versões dos drivers incluem a seguinte alteração:

Para saber mais sobre esta versão, consulte as Notas da versão v4.5.3 no GitHub.

Novidades em 4.5.2

O 4.5.2 versões dos drivers incluem as seguintes alterações:

Para saber mais sobre esta versão, consulte as Notas da versão v4.5.2 no GitHub.

Novidades no 4.5.1

O 4.5.1 versões dos drivers incluem a seguinte alteração:

Para saber mais sobre esta versão, consulte as Notas da versão v4.5.1 no 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.

Para saber mais sobre esta versão, consulte as Notas da versão v4.5.0 no 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:

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

Para saber mais sobre esta versão, consulte as Notas da versão v4.4.0 no 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.

Para saber mais sobre esta versão, consulte as Notas da versão v4.3.1 no 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 de versão v4.3 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 Changelog do driver 4.2 no repositório do GitHub mongo-cxx-driver.

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.

Para saber mais sobre esta versão, consulte as notas de versão v4.2 no 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ão v4.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.

Para saber mais sobre esta versão, consulte as notas de versão v4.1 no 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.

Para saber mais sobre esta versão, consulte as notas de versão v4.0 no 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.

Para saber mais sobre esta versão, consulte as notas de versão v3.11 no 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.

Para saber mais sobre esta versão, consulte as notas de versão v3.10 no 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 módulo FetchContent para baixar e construir a biblioteca de polyfill SNMLSTC Core, se não for fornecida pelo sistema, em vez do módulo ExternalProject. Ele também não corrige diretivas include 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.

Para saber mais sobre esta versão, consulte as notas de versão v3.9 no Github.