Notas de versão

Novidades no 3.0

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

• Adiciona a opção de conexão MongoClientSettings.TranslationOptions, que especifica opções para traduzir queries LINQ para a API de query. Consulte Especificar opções de conexão para obter mais informações.

• Adiciona suporte para o Half tipo, que representa um número de ponto flutuante de meia precisão. Este tipo está disponível no .NET 5 e posterior. Para saber mais sobre o Half tipo, consulte a página de referência da API Meia Estrutura no MSDN.

• A interface IMongoClient herda a interface IDisposable. Como resultado, a classe MongoClient e outras classes que implementam a interface IMongoClient contêm uma opção Disp- Adds support for the ``sort a ser passada para atualizar os comandos.ose()'' método , que descarta o cliente. Este método não descarta o cluster subjacente e conexões com o servidor MongoDB . Para descartar o cluster e as conexões, chame o método ClusterRegistry.UnregisterAndDisposeCluster(). A implementação da interface IDisposable é experimental.

  Para saber mais sobre a IDisposable interface e o uso do Dispose() método, consulte Padrão de descarte no MSDN.

• Adiciona suporte para o DateOnly tipo, que representa um valor de data sem nenhum componente de tempo. Este tipo está disponível no .NET 6 e posterior. Para saber mais sobre o DateOnly tipo, consulte a estrutura DateOnly. Página de referência da API no MSDN.

• Adiciona suporte para o TimeOnly tipo, que representa um valor de tempo sem componente de data. Este tipo está disponível no .NET 6 e posterior. Para saber mais sobre o TimeOnly tipo, consulte a estrutura TimeOnly. Página de referência da API no MSDN.

• Adiciona suporte para projeção implícita no lado do cliente ao usar o método Find(), o método Select() ou o estágio de agregação Project() com o provedor LINQ3. Nas versões anteriores do driver, você podia executar a projeção do lado do cliente com o provedor LINQ3 somente depois de chamar o método ToEnumerable() ou AsEnumerable().

  Para saber como habilitar e usar a projeção do lado do cliente para um método de driver, selecione a guia correspondente:

  Método encontrar()

  Método select()

  Método Projeto()

  // Enable client-side projection
  var findOptions = new FindOptions();
  findOptions.TranslationOptions = new ExpressionTranslationOptions
  {
      EnableClientSideProjections = true
  };
  var find = collection
      .Find(doc => doc.Id == 1, findOptions);
      .Project(doc => new { R = MyFunction(doc.Name) });

  // Enable client-side projection
  var aggregateOptions = new AggregateOptions();
  aggregateOptions.TranslationOptions = new ExpressionTranslationOptions
  {
      EnableClientSideProjections = true
  };
  var queryable = collection
      .AsQueryable(aggregateOptions)
      .Where(doc => doc.Id == 1)
      .Select(doc => new { R = MyFunction(doc.Name) });

  // Enable client-side projection
  var aggregateOptions = new AggregateOptions();
  aggregateOptions.TranslationOptions = new ExpressionTranslationOptions
  {
      EnableClientSideProjections = true
  };
  var aggregate = collection
      .Aggregate(aggregateOptions)
      .Project(doc => new { R = MyFunction(doc.Name) });

  Dica

  Configurações do Mongo Client

  Para habilitar a projeção no lado do cliente para todas as queries em um cliente, defina a propriedade TranslationOptions do seu objeto MongoClientSettings, conforme mostrado no exemplo a seguir:

  clientSettings.TranslationOptions = new ExpressionTranslationOptions
  {
      EnableClientSideProjections = true
  };

  Para saber mais sobre como usar o pipeline de agregação com o driver .NET/C#, consulte Operações de agregação.

• Adiciona uma API MongoClient para operações de escrita em massa. Para saber mais sobre operações de escrita em massa, consulte Operações de escrita em massa.

Para obter mais informações sobre esta versão, consulte as 3.0 notas de versão v.

Novidades no 2.30

O driver 2.30 não introduz novos recursos ou correções de bugs. Seu objetivo é facilitar a migração para a v3.x do driver .NET/C# marcando as APIs públicas que foram removidas na v3.0 como obsoletas.

Novidades no 2.29

A versão do driver 2.29 adiciona suporte para a versão 8.0 do MongoDB Server e inclui as seguintes novas funcionalidades:

• Adiciona suporte para v2 do protocolo de faixa Queryable Encryption .

• Adiciona suporte para índices de intervalo para Queryable Encryption. Para obter mais informações sobre Queryable Encryption, consulte Queryable Encryption no manual do MongoDB Server .

Para obter mais informações sobre esta versão, consulte as 2.29 notas de versão v.

Novidades no 2.28

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

• Adiciona suporte para conversões numéricas adicionais envolvendo Nullable<T>.

• Adiciona suporte para a opção delegated ao usar KMIP para CSFLE ou Queryable Encryption.

Para obter mais informações sobre esta versão, consulte as 2.28 notas de versão v.

Novidades no 2.27

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

• Adiciona suporte para o operador de agregação $sample .

• Implementa o método Equals() para serializadores no LINQ3.

• Garante que as preocupações de leitura e gravação não sejam aplicadas aos comandos do auxiliar do índice do Atlas Search para evitar erros.

• Não permite o uso do caractere vírgula em authMechanismProperties valores de string de conexão ao usar o mecanismo de autenticação MONGODB-OIDC .

• Corrige um bug de tradução que causava um erro durante a serialização envolvendo números de tamanhos diferentes.

• Adiciona suporte para distribuições Linux que utilizam a biblioteca do libdl.so.2 .

Para obter mais informações sobre esta versão, consulte as 2.27 notas de versão v.

Novidades no 2.26

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

• Adicionado suporte para usar o método de agregação SelectMany() dentro dos estágios de agregação Select() e Project() .

• Adicionado suporte para chamadas Dictionary.ContainsValue() em queries LINQ.

• Suporte adicionado para concatenação de string de tipos mistos.

• Uso habilitado do crypto nativo em vinculações do libmongocrypt .

• Suporte adicionado para serialização de estruturas Memory e ReadOnlyMemory. Para saber mais sobre como implementar esses tipos, consulte a seção Aprimorar o desempenho da serialização da matriz do guia Serialização.

• Suporte adicionado para o provedor de identidade GCP ao usar o mecanismo de autenticação MONGODB-OIDC . Para saber mais, consulte GCP IMDS no guia de Mecanismos de Autenticação Empresarial.

• Implementação da assinatura de pacotes NuGet.

• Implementou novas tentativas de leitura e gravação em outras instâncias mongos quando possível.

Novidades no 2.25

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

• Suporte adicionado para o mecanismo de autenticação do MONGODB-OIDC e aquisição automática de token para o Provedor de Identidade do Azure.

• Foi adicionado o nome da classe à mensagem de erro relatada quando BsonClassMapSerializer não consegue localizar um criador correspondente.

• Foi adicionado um campo LoggedStages para exibir o MQL executado após a execução de uma query LINQ.

• Suporte adicionado para substituir o nome do serviço "mongodb" por um personalizado usando a opção de conexão srvServiceName. Para saber mais, consulte o guia Especificar opções de conexão.

• Comportamento aprimorado de operações de gravação em massa para evitar enumerar o parâmetro de solicitações mais de uma vez.

Novidades no 2.24

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

• Adicionado o método IMongoCollection.DistinctMany().

• Suporte adicionado para os argumentos opcionais mais recentes para a expressão de agregação $dateFromString .

• Suporte adicionado para classificação por pontuação no estágio de agregação $search .

• Foi adicionado o construtor VectorSearchScore para o estágio de agregação $vectorSearch .

• Suporte adicionado para o operador $in no Atlas Search.

• Adicionados os métodos Mql.Exists(), Mql.IsMissing() e Mql.IsNullOrMissing() para query LINQ.

• Adicionado suporte para o método IComparable.CompareTo() em queries LINQ.

• Foi adicionado suporte para chamadas aninhadas ao método AsQueryable() para oferecer suporte a queries LINQ pelo fornecedor do MongoDB Entity Framework Core.

• Suporte adicionado para TLS 1.3.

• Atualizou a versão do pacote libmongocrypt para 1.8.2.

• Corrigido um segfault no Kerberos (libgssapi) em distribuições Linux mais recentes.

• Corrigido um bug do GridFS em que o download de um arquivo causava um erro se um arquivo maior com o mesmo ID também tivesse sido carregado.

• O erro de servidor ExceededTimeLimit agora pode ser repetido para operações de leitura e gravação.

• Ao ser executado em um ambiente de função como serviço (FaaS), como o Amazon Web Services Lambda, o driver agora usa o mecanismo de monitoramento de sondagem.

• Para melhorar a compatibilidade do MongoDB Atlas Serverless, o driver agora usa OP_MSG para autenticação se o servidor suportar.

Novidades no 2.23

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

• Melhorias e correções de bugs na integração do LINQ3 .

• Suporte adicionado para operadores de agregação bitwise.

• Suporte adicionado para o operador $out nas coleções de séries temporais do MongoDB.

• ChangeStreamSplitLargeEvent adicionado para lidar com eventos de fluxo de alterações maiores que 16 MB.

Novidades no 2.22

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

• Melhorias e correções de bugs na integração do LINQ3 .

• Suporte adicionado para estágios de agregação $set e $vectorSearch .

• Suporte de sinônimos adicionado para Atlas Search.

• Alocação de memória reduzida ao usar criptografia.

• Foram adicionadas mensagens de registro para eventos de descoberta e monitoramento de servidor (SDAM). Para obter mais informações sobre esses eventos, consulte a especificação de monitoramento e registro de SDAM do MongoDB .