Para agentes de IA: um índice de documentação está disponível em https://www.mongodb.com/pt-br/docs/llms.txt — as versões de markdown de todas as páginas estão disponíveis anexando .md a qualquer caminho de URL.
See how MongoDB 9.0 delivers up to 2x higher throughput.
MongoDB Branding Shape
Register now >
Menu Docs

Notas de versão

Descubra as novidades de cada versão:

Importante

Para garantir que o número da versão principal do fornecedor esteja alinhado com as versões do Entity Framework Core, o fornecedor do MongoDB Entity Framework Core não limita as alterações significativas às versões principais. Em vez disso, alterações significativas e significativas são feitas em versões menores.

Esta seção lista as alterações introduzidas nas seguintes versões:

O 10.0.4 a versão do provedor inclui as seguintes alterações:

Importante

A versão MongoDB Entity Framework Core Provider v10.0.4 inclui correções para os seguintes problemas de segurança:

Para obter as informações mais recentes sobre as atualizações de segurança do MongoDB , consulte Boletins de segurança do MongoDB .

  • Corrige a geração de esquema Queryable Encryption quando você especifica um nome de banco de dados

  • Interrompe o registro da string de conexão para evitar publicações indesejadas

  • Corrige um AssertTranslationFailed de captura simples que oculta dados errados em incluir conjuntos de especificações

  • Corrige duas referências incluídas para o mesmo tipo de entidade de destino

  • Corrige chamadas ThenInclude irmanadas através do mesmo tipo de destino coletado em um $lookup

  • Corrige um salto transitivo ThenInclude erroneamente direcionado para uma navegação de chamariz no nível da raiz

  • Corrige uma entidade de junção de muitos para muitos que perde uma chave composta para uma propriedade de sombra duplicada

  • Corrige um ThenInclude cujo seletor de chave atinge uma navegação de propriedade

  • Corrige Take(0) lançando um ArgumentOutOfRangeException

  • Corrige Equals() com tipos numéricos incompatíveis lançando um InvalidCastException

  • Atualiza o driver .NET/C# para 3.11.2

Para obter mais informações sobre esta versão, consulte as notas de versão v10.0.4 no Github.

O 10.0.3 a versão do provedor inclui as seguintes alterações:

Importante

A versão do MongoDB Entity Framework Core Provider v10.0.3 inclui uma correção para CVE-2026-92756.

Para obter as informações mais recentes sobre as atualizações de segurança do MongoDB , consulte Boletins de segurança do MongoDB .

  • Adiciona suporte para chamadas, navegações e junções de Include() entre coleções

  • Adiciona suporte para operadores LINQ como ToArray(), ToList() e FirstOrDefault() aplicados a uma string na projeção final

  • Adiciona suporte para a criação de índices de pesquisa MongoDB

  • Adiciona suporte para operações em massa do ExecuteUpdate() e ExecuteDelete()

  • Adiciona metadados ao instanciado MongoClient

  • Rejeita tokens de simultaneidade em entidades pertencentes

  • Corrige uma leitura de sombra ou escalar EF.Property() em uma entidade unida em uma projeção

  • Corrige um bug em que um valor calculado que combina duas propriedades (por exemplo, c.Age * c.Score) retornava um resultado incorreto quando projetado junto com uma entidade inteira.

  • Corrige os filtros discriminadores LINQ do driver para corresponder aos valores convertidos ou representados

  • Corrige um erro em que o construtor de cópia MongoOptionsExtension eliminava as configurações CryptExtraOptions e QueryableEncryptionSchemaMode quando encadeado após os métodos WithCryptProvider() ou WithQueryableEncryptionSchemaMode()

  • Corrige uma query compilada que termina em um operador de query

  • Corrige um erro em que chamar Sum() em um conjunto vazio retornava null para projeções anuláveis

  • Corrige um bug em que a chamada de Contains() em uma collection escalar projetada retornava resultados incorretos

  • Atualiza a dependência da versão do Entity Framework Core para 10.0.11

Para obter mais informações sobre esta versão, consulte as notas de versão v10.0.3 no Github.

O 10.0.2 a versão do provedor inclui as seguintes alterações:

  • Melhora a projeção Select() para oferecer suporte à mistura de seleções de campo e de nível de entidade

  • Adiciona suporte para comparar entidades entre si e com nulo

  • Reescreve a lógica de vinculação para ser mais robusta com formas não triviais e melhor suportar projeções Select()

  • Adiciona suporte para String.Replace() e String.Compare() por meio de melhorias no driver MongoDB .NET/C# subjacente

  • Corrige um bug em que HasAtlasIndexes verificava apenas a primeira entidade de propriedade em vez de todas as entidades de propriedade

  • Corrige mensagens de log que relataram ExecutingBulkWrite como Executed com um tempo decorrido incorreto e que não incluíam os valores pretendidos

  • Corrige conversões inválidas em caminhos de construtores fluentes raramente usados para Decimal128 e QueryableEncryptionType

Para obter mais informações sobre esta versão, consulte as notas de versão v10.0.2 no Github.

O 10.0.1 a versão do provedor inclui as seguintes alterações:

  • Corrige um erro para salvar alterações em uma coleção quando um item é removido

Para obter mais informações sobre esta versão, consulte as notas de versão v10.0.1 no Github.

O 10.0.0 a versão do provedor inclui as seguintes alterações:

  • Adiciona compatibilidade com Entity Framework Core v10.0

  • Suporta o assistente do Core EF.Constant em queries LINQ

  • Emite QueryCompilationStarted mensagens de log quando uma query é compilada

  • Mapeia o discriminador para _t, a menos que tenha sido explicitamente configurado

  • Melhora a detecção de operações LINQ não suportadas e mensagens de erro associadas

Para obter mais informações sobre esta versão, consulte as notas de versão v10.0.0 no Github.

Esta seção lista as alterações introduzidas nas seguintes versões:

O 9.1.3 a versão do provedor inclui as seguintes alterações:

  • Adiciona suporte para chamadas, navegações e junções de Include() entre coleções

  • Adiciona suporte para operadores LINQ como ToArray(), ToList() e FirstOrDefault() aplicados a uma string na projeção final

  • Adiciona suporte para a criação de índices de pesquisa MongoDB

  • Adiciona suporte para operações em massa do ExecuteUpdate() e ExecuteDelete()

  • Adiciona metadados ao instanciado MongoClient

  • Rejeita tokens de simultaneidade em entidades pertencentes

  • Corrige uma leitura de sombra ou escalar EF.Property() em uma entidade unida em uma projeção

  • Corrige um bug em que um valor calculado que combina duas propriedades (por exemplo, c.Age * c.Score) retornava um resultado incorreto quando projetado junto com uma entidade inteira.

  • Corrige os filtros discriminadores LINQ do driver para corresponder aos valores convertidos ou representados

  • Corrige um erro em que o construtor de cópia MongoOptionsExtension eliminava as configurações CryptExtraOptions e QueryableEncryptionSchemaMode quando encadeado após os métodos WithCryptProvider() ou WithQueryableEncryptionSchemaMode()

  • Corrige uma query compilada que termina em um operador de query

  • Corrige um erro em que chamar Sum() em um conjunto vazio retornava null para projeções anuláveis

  • Corrige um bug em que a chamada de Contains() em uma collection escalar projetada retornava resultados incorretos

  • Atualiza a dependência da versão do Entity Framework Core para 9.0.19

Para obter mais informações sobre esta versão, consulte as notas de versão v9.1.3 no Github.

O 9.1.2 a versão do provedor inclui as seguintes alterações:

  • Melhora a projeção Select() para oferecer suporte à mistura de seleções de campo e de nível de entidade

  • Adiciona suporte para comparar entidades entre si e com nulo

  • Reescreve a lógica de vinculação para ser mais robusta com formas não triviais e melhor suportar projeções Select()

  • Adiciona suporte para String.Replace() e String.Compare() por meio de melhorias no driver MongoDB .NET/C# subjacente

  • Corrige um bug em que HasAtlasIndexes verificava apenas a primeira entidade de propriedade em vez de todas as entidades de propriedade

  • Corrige mensagens de log que relataram ExecutingBulkWrite como Executed com um tempo decorrido incorreto e que não incluíam os valores pretendidos

  • Corrige conversões inválidas em caminhos de construtores fluentes raramente usados para Decimal128 e QueryableEncryptionType

Para obter mais informações sobre esta versão, consulte as notas de versão v9.1.2 no Github.

O 9.1.1 a versão do provedor inclui as seguintes alterações:

  • Corrige um erro para salvar alterações em uma coleção quando um item é removido

Para obter mais informações sobre esta versão, consulte as notas de versão v9.1.1 no Github.

O 9.1.0 a versão do provedor inclui as seguintes alterações:

  • Suporta o assistente do Core EF.Constant em queries LINQ

  • Emite QueryCompilationStarted mensagens de log quando uma query é compilada

  • Mapeia o discriminador para _t, a menos que tenha sido explicitamente configurado

  • Melhora a detecção de operações LINQ não suportadas e mensagens de erro associadas

Para obter mais informações sobre esta versão, consulte as notas de versão v9.1 no Github.

Esta seção lista as alterações introduzidas nas seguintes versões:

O 9.0.4 a versão do provedor inclui as seguintes alterações:

  • Adiciona suporte para traduzir o método DateTime.Compare() em queries LINQ

  • Adiciona o parâmetro CreateCollectionOptions à estrutura MongoDatabaseCreationOptions

  • Corrige um bug em que collections BSON vazias não resultavam em collections CLR vazias quando você usava a opção QueryTrackingBehavior.NoTracking

  • Corrige uma exceção de descarte que ocorreu dentro do método CreateExecutionStrategy().ExecuteInTransaction

  • Adiciona suporte para v3.6 do MongoDB .NET/C# Driver

  • Upgrades para windows-2022-latest para compilações do Windows CI

  • Usa o driver MongoDB .NET/C# como única fonte da verdade para tipos de dados

Para obter mais informações sobre esta versão, consulte as notas de versão v9.0.4 no Github.

O 9.0.3 a versão do provedor inclui as seguintes alterações:

  • Adiciona suporte a transações explícitas usando as interfaces MongoTransactionManager e IMongoTransactionManager

  • Aumenta o tempo limite padrão para a criação de índices vetoriais de 15 para 60 segundos e registra quando o sistema está aguardando a conclusão do processo

  • Corrige a lógica de registro para garantir que, quando o registro de dados confidenciais estiver desativado, as mensagens de aviso de query vetorial não incluam os detalhes de query sensível

  • Atualiza os campos de filtro de índice vetorial para usar nomes de elementos em vez de nomes de propriedade C#

Para obter mais informações sobre esta versão, consulte as notas de versão v9.0.3 no Github.

O 9.0.2 a versão do provedor inclui as seguintes alterações:

  • Adiciona suporte para o MongoDB Vector Search. Para aprender mais, consulte MongoDB Vector Search no manual do MongoDB Server.

  • Torna públicas as classes de convenções do fornecedor.

  • Corrige um bug em que as projeções que usam o método EF.Property() geraram um erro NullReferenceException.

Para obter mais informações sobre esta versão, consulte as notas de versão v9.0.2 no Github.

O 9.0.1 a versão do provedor inclui as seguintes alterações:

  • Adiciona suporte a esquema do lado do servidor e uma nova API fluente IsEncrypted para Queryable Encryption

  • Adiciona suporte para chaves alternativas

  • Permite a supressão de exceção quando uma propriedade de tipo de entidade tem o atributo ColumnAttribute

  • Adiciona suporte de seeding de banco de dados por meio do método EnsureCreated()

  • Adiciona suporte para mapeamento de estruturas simples que são usadas como propriedades simples

  • Adiciona suporte para materializar propriedades de somente leitura

  • Adiciona suporte para propriedades de sombra como chaves primárias

Para obter mais informações sobre esta versão, consulte as notas de versão v9.0.1 no Github.

A versão do fornecedor 9.0 inclui as seguintes novas funcionalidades:

  • Novas funcionalidades e alterações também incluídas na versão8.3

  • Atualiza a dependência da versão do Entity Framework Core para 9.0

Para saber mais sobre as alterações significativas na versão 9.0, consulte a seção Alterações significativas da versão 9.0.0 .

Esta seção lista as alterações introduzidas nas seguintes versões:

O 8.4.3 a versão do provedor inclui as seguintes alterações:

  • Adiciona suporte para chamadas, navegações e junções de Include() entre coleções

  • Adiciona suporte para operadores LINQ como ToArray(), ToList() e FirstOrDefault() aplicados a uma string na projeção final

  • Adiciona suporte para a criação de índices de pesquisa MongoDB

  • Adiciona metadados ao instanciado MongoClient

  • Rejeita tokens de simultaneidade em entidades pertencentes

  • Corrige uma leitura de sombra ou escalar EF.Property() em uma entidade unida em uma projeção

  • Corrige um bug em que um valor calculado que combina duas propriedades (por exemplo, c.Age * c.Score) retornava um resultado incorreto quando projetado junto com uma entidade inteira.

  • Corrige os filtros discriminadores LINQ do driver para corresponder aos valores convertidos ou representados

  • Corrige um erro em que o construtor de cópia MongoOptionsExtension eliminava as configurações CryptExtraOptions e QueryableEncryptionSchemaMode quando encadeado após os métodos WithCryptProvider() ou WithQueryableEncryptionSchemaMode()

  • Corrige uma query compilada que termina em um operador de query

  • Corrige um erro em que chamar Sum() em um conjunto vazio retornava null para projeções anuláveis

  • Corrige um bug em que a chamada de Contains() em uma collection escalar projetada retornava resultados incorretos

  • Atualiza a dependência da versão do Entity Framework Core para 8.0.30

Para obter mais informações sobre esta versão, consulte as notas de versão v8.4.3 no Github.

O 8.4.2 a versão do provedor inclui as seguintes alterações:

  • Melhora a projeção Select() para oferecer suporte à mistura de seleções de campo e de nível de entidade

  • Adiciona suporte para comparar entidades entre si e com nulo

  • Reescreve a lógica de vinculação para ser mais robusta com formas não triviais e melhor suportar projeções Select()

  • Adiciona suporte para String.Replace() e String.Compare() por meio de melhorias no driver MongoDB .NET/C# subjacente

  • Corrige um bug em que HasAtlasIndexes verificava apenas a primeira entidade de propriedade em vez de todas as entidades de propriedade

  • Corrige mensagens de log que relataram ExecutingBulkWrite como Executed com um tempo decorrido incorreto e que não incluíam os valores pretendidos

  • Corrige conversões inválidas em caminhos de construtores fluentes raramente usados para Decimal128 e QueryableEncryptionType

Para obter mais informações sobre esta versão, consulte as notas de versão v8.4.2 no Github.

O 8.4.1 a versão do provedor inclui as seguintes alterações:

  • Corrige um erro para salvar alterações em uma coleção quando um item é removido

Para obter mais informações sobre esta versão, consulte as notas de versão v8.4.1 no Github.

O 8.4.0 a versão do provedor inclui as seguintes alterações:

  • Mapeia o discriminador para _t, a menos que tenha sido explicitamente configurado

  • Melhora a detecção e o envio de mensagens de operações LINQ não compatíveis

  • Usa consistentemente o EF Core em vez do EF

Para obter mais informações sobre esta versão, consulte as notas de versão v8.4.0 no Github.

Esta seção lista as alterações introduzidas nas seguintes versões:

O 8.3.4 a versão do provedor inclui as seguintes alterações:

  • Adiciona suporte para traduzir o método DateTime.Compare() em queries LINQ

  • Adiciona o parâmetro CreateCollectionOptions à estrutura MongoDatabaseCreationOptions

  • Adiciona suporte para v3.6 do MongoDB .NET/C# Driver

  • Corrige um bug em que collections BSON vazias não resultavam em collections CLR vazias quando você usava a opção QueryTrackingBehavior.NoTracking

  • Corrige uma exceção de descarte que ocorreu dentro do método CreateExecutionStrategy().ExecuteInTransaction

Para obter mais informações sobre esta versão, consulte as notas de versão v8.3.4 no Github.

O 8.3.3 a versão do provedor inclui as seguintes alterações:

  • Adiciona suporte a transações explícitas usando as interfaces MongoTransactionManager e IMongoTransactionManager

  • Aumenta o tempo limite padrão para a criação de índices vetoriais de 15 para 60 segundos e registra quando o sistema está aguardando a conclusão do processo

  • Corrige a lógica de registro para garantir que, quando o registro de dados confidenciais estiver desativado, as mensagens de aviso de query vetorial não incluam os detalhes de query sensível

  • Atualiza os campos de filtro de índice vetorial para usar nomes de elementos em vez de nomes de propriedade C#

Para obter mais informações sobre esta versão, consulte as notas de versão v8.3.3 no Github.

O 8.3.2 a versão do provedor inclui as seguintes alterações:

  • Adiciona suporte para o MongoDB Vector Search. Para aprender mais, consulte MongoDB Vector Search no manual do MongoDB Server.

  • Torna públicas as classes de convenções do fornecedor.

  • Corrige um bug em que as projeções que usam o método EF.Property() geraram um erro NullReferenceException.

Para obter mais informações sobre esta versão, consulte as notas de versão v8.3.2 no Github.

O 8.3.1 a versão do provedor inclui as seguintes alterações:

  • Adiciona suporte a esquema do lado do servidor e uma nova API fluente IsEncrypted para Queryable Encryption

  • Adiciona suporte para chaves alternativas

  • Permite a supressão de exceção quando uma propriedade de tipo de entidade tem o atributo ColumnAttribute

  • Adiciona suporte de seeding de banco de dados por meio do método EnsureCreated()

  • Adiciona suporte para mapeamento de estruturas simples que são usadas como propriedades simples

  • Adiciona suporte para materializar propriedades de somente leitura

  • Adiciona suporte para propriedades de sombra como chaves primárias

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

A versão do fornecedor 8.3 inclui as seguintes novas funcionalidades:

  • Adiciona suporte para configurar a representação de BSON no PropertiesConfigurationBuilder.

  • Adiciona suporte de nível de configuração para HasDateTimeKind().

  • Altera o comportamento para aplicar HasBsonRepresentation a propriedades anuláveis. Para saber mais, consulte o guia da versão 8.3.0 Alterações significativas no upgrade da versão do provedor.

  • Altera o comportamento para permitir testes de nulidade para collections de navegação.

Esta seção lista as alterações introduzidas nas seguintes versões:

O 8.2.3 a versão do provedor inclui as seguintes novas funcionalidades:

  • Adiciona suporte para agregações escalares de nível superior, como Sum, Average, Min e Max

  • Adiciona suporte para a geração ObjectId ao usar o tipo string para a propriedade _id

  • Altera o comportamento para não gerar mais um erro quando o elemento BSON está ausente em uma coleção própria

O 8.2.2 a versão do provedor inclui as seguintes novas funcionalidades:

  • Atualiza a mensagem de erro DbUpdateConcurrencyException para incluir os tipos de entidades responsáveis pelo erro

  • Adiciona suporte para conversores de valor em relação a propriedades anuláveis

  • Adiciona suporte para usar o método HasIndex() em entidades próprias

  • Adiciona suporte para tipos de array de bytes

O 8.2.1 a versão do provedor inclui as seguintes novas funcionalidades:

  • Adiciona suporte para propriedades de sombra do Entity Framework, propriedades que não são definidas em sua classe de entidade .NET, mas estão incluídas no modelo Entity Framework Core e mapeadas para o banco de dados.

  • Adiciona suporte para o uso do método HasIndex() Entity Framework Fluent API para criar índices para uma propriedade quando você cria um banco de dados.

    O exemplo seguinte mostra como especificar índices para as propriedades Customer.Name, Order.OrderRef, Address.ZipCode e Documents.DocRef:

    var context = MyContext.CreateCollectionOptions(database.MongoDatabase, mb =>
    {
    mb.Entity<Customer>().HasIndex(c => c.Name);
    mb.Entity<Order>().HasIndex(o => o.OrderRef).IsUnique();
    mb.Entity<Address>().HasIndex(o => o.ZipCode, "custom_index_name");
    mb.Entity<Documents>()
    .HasIndex(d => d.DocRef)
    .HasCreateIndexOptions(new CreateIndexOptions { Sparse = true });
    });
    var result = context.Database.EnsureCreated();
  • Adiciona suporte para os métodos MQL.Exists(), MQL.IsMissing() e MQL.IsNullOrMissing() em queries LINQ. Esses métodos funcionam com propriedades reais e de sombra.

A versão do fornecedor 8.2 inclui as seguintes novas funcionalidades:

  • Adiciona suporte para discriminadores de tipo

  • Adiciona suporte para v3.0 do MongoDB .NET/C# Driver

  • Adiciona suporte para tipos de CLR do TimeOnly e DateOnly

Aviso

Mudanças de última hora

O fornecedor v8.1 introduz as seguintes alterações significativas:

  • O EF Core Provider executa todas as alterações como transações MongoDB . Se o seu aplicação usa uma versão do MongoDB Server anterior à v5.0, ou não for executado em um conjunto de réplicas, será necessário reconfigurar seu aplicação.

  • O formato de armazenamento GUID padrão foi alterado do formato CSharpLegacy binário para o formato Standard .

  • Modificou a interface do IMongoClientWrapper para fornecer registro de serviço para a classe MongoClientWrapper . Você não deve implementar a interface IMongoClientWrapper em seu aplicação.

  • Os casos CamelCaseElementNameConvention possuem entidades com base no nome da propriedade em vez do nome da classe .

Para obter mais informações sobre essas alterações significativas, consulte a versão 8.1.0 Alterações significativas no guia da versão do provedor de atualização.

A versão do fornecedor 8.1 inclui as seguintes novas funcionalidades:

  • Suporte para simultaneidade otimista através do seguinte:

    • IsConcurrencyToken() método ou o atributo ConcurrencyCheck()

    • IsRowVersion() método ou o atributo Timestamp

  • Suporte para mapear propriedades do Dictionary e ReadOnlyDictionary

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