NOVIDADES

Próximas alteração interruptiva

De acordo com os agendamentos do ciclo de vida do software MongoDB, uma próxima versão secundária do driver .NET/C# aumentará a versão mínima do MongoDB Server de 4.0 para 4.2. O driver .NET/C# não será mais compatível com o MongoDB Server 4.0.

Novidades no 3.3

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

• Adiciona um novo campo NamespaceType que indica o tipo do objeto criado para eventos create na classe ChangeStreamDocument. Para saber mais sobre change streams, consulte o guia Monitorar alterações de dados.

• Adiciona os seguintes recursos de criptografia em execução :

  • Suporte para o estágio de agregação $lookup

  • Uma propriedade ClientEncryptionOptions que configura a vida útil do cache da chave de criptografia de dados

  Para saber mais sobre a criptografia em execução, consulte o guia criptografia em execução.

• Adiciona as seguintes funcionalidades do LINQ:

  • Suporte para os métodos de agregação LINQ SkipWhile() e TakeWhile(). Para saber mais, consulte as seções Ignorar uma condição e Limitar uma condição do guia LINQ.

  • Suporte para a expressão $sigmoid em queries LINQ.

  • Suporte para o uso da sintaxe LINQ para acessar qualquer chave de dicionário serializada como uma cadeia de caracteres, independentemente do tipo de dados subjacente.

• Adiciona suporte para o estágio de agregação $rankFusion, que permite a pontuação de resultados baseada em classificação em resultados combinados de vários pipelines.

• Adiciona suporte para queries $elemMatch diretamente em relação aos valores, fornecendo uma sobrecarga do método ElemMatch() que utiliza apenas um parâmetro de filtro. Para saber mais, consulte a seção Operadores de array do guia Construtores.

• Adiciona suporte para utilizar o método OfType<T>() e operador is para verificar o tipo de um discriminador escalar.

Novidades no 3.2

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

• Adiciona uma nova convenção do ObjectSerializerAllowedTypesConvention que permite a você especificar quais tipos podem ser serializados e desserializados pelo serializador de objeto . Para saber mais sobre convenções, consulte o guia de Convenções.

• Adiciona um novo construtor para a classe EnumRepresentationConvention que permite usar o parâmetro topLevelOnly para especificar se a convenção se aplica somente a propriedades enumeração ou a todas as propriedades que incluem coleções de enums.

  Você pode instanciar a classe EnumRepresentationConvention utilizando o novo construtor como mostrado no seguinte exemplo:

  EnumRepresentationConvention(BsonType representation, bool topLevelOnly);

• Otimiza as projeções no lado do cliente para recuperar somente os campos necessários do servidor, em vez de recuperar todos os campos e filtrá-los.

• Adiciona as seguintes classes para suportar representações de vetores binários no Atlas Vector Search:

  • BinaryVectorFloat32

  • BinaryVectorInt8

  • BinaryVectorPackedBit

  Para saber mais sobre o Atlas Vector Search com o driver .NET/C#, consulte o guia do Atlas Vector Search.

• Adiciona a propriedade DocumentFormat ao DateOnlySerializer. Esta propriedade permite a você personalizar a maneira como o driver serializa os valores do DateOnly. Esta versão também adiciona o atributo [BsonDateOnlyOptions()] para personalizar o comportamento de serialização para valores DateOnly no nível da propriedade. Para saber mais, consulte a seção Custom DateOnly Serialization do guia POCOs.

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 objetos ImmutableArray e a serialização para outras collections imutáveis é mais eficiente em termos de memória.

• Adiciona o tipo SearchIndexType para suportar a criação de índices do Atlas Vector Search programaticamente. Para saber mais, consulte o guia Atlas Search e Vector Search Indexes.

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

• Adiciona suporte para as seguintes queries do Atlas Search :

  • Usando o método do operador Equals() em valores null e Guid

  • Usando o método do operador In() em valores Guid

  Para saber mais sobre esses métodos, consulte a seção Operadores e coletores do Atlas Search do guia 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 uma opção de classificação para atualização e substituição de operações. Essa alteração permite que você defina uma ordem de classificação se vários documentos corresponderem ao seu filtro ao tentar atualizar ou substituir um único documento. Para saber mais, consulte os guias Atualizar um e Substituir documentos.

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