NOVIDADES

Novidades no 3.1

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

• Adiciona novos serializadores padrão para coleções imutáveis no namespace System.Collections.Immutable . O driver agora pode serializar ImmutableArray objetos e a serialização para outras collections imutáveis é mais eficiente em termos de memória.

• Adiciona suporte para o tipo de campo de token e expressões de campo de array com construtores Atlas Search para o equals operador. Para saber mais sobre como usar o Atlas Search com o driver .NET/C#, consulte Atlas Search.

• Adiciona suporte para paginação sequencial no Atlas Search.

• Adiciona suporte para nomes de host SRV válidos com menos de 3 partes.

• Adiciona suporte para os métodos Exists, IsMissing e IsNullOrMissing em filtros de MongoDB Query API .

• Adiciona suporte para a pesquisa vetorial do vizinho exato (ENN). Para saber mais sobre a Vector Search ENN, consulte Executar queries de Vector Search na documentação do Atlas Search .

• Adiciona suporte para a sort opção ser passada para atualizar comandos. To learn more about using update commands with the .NET/C# Driver, see csharp-change-guide.

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

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 Opções de Conexão para obter mais informações.

• Adiciona suporte para o tipo Half, 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 um método Dispose() , 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 tipo DateOnly, 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 tipo TimeOnly, 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 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 notas de versão v .3.0

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 notas de versão v .2.29

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 notas de versão v .2.28

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 notas de versão v .2.27

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 .

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

• 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 IMongoCollection.DistinctMany() método.

• 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 change stream superiores a 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 .