Menu Docs
Página inicial do Docs
/
Idiomas
/
C#
/
Provedor do EF Core

Versão do provedor de atualização

Nesta página

  • Visão geral
  • Mudanças de última hora

Visão geral

Nesta seção, você pode identificar as alterações essenciais que deve fazer no aplicação ao atualizar o provedor para uma nova versão.

Antes de atualizar, execute as seguintes ações:

  • Certifique-se de que a nova versão seja compatível com a versão do MongoDB Server à qual seu aplicação se conecta e com a versão .NET em que seu aplicação é executado. Consulte a seçãoCompatibilidade do para obter essas informações.

  • Resolva quaisquer alterações significativas entre a versão atual do fornecedor que seu aplicação está usando e a versão de atualização planejada na seção Alterações significativas.

Mudanças de última hora

Uma alteração interruptiva significativa é uma modificação de uma convenção ou comportamento a partir de uma versão específica do provedor. Esse tipo de alteração pode impedir que seu aplicação funcione corretamente se não for resolvido antes de atualizar o fornecedor.

As mudanças significativas nesta seção são categorizadas pela versão do provedor que as introduziram. Ao atualizar as versões do fornecedor, resolva todas as alterações significativas entre a versão atual e a atualizada. Por exemplo, se você estiver atualizando o provedor da v8.0 para a v8.5, resolva todas as alterações significativas da versão posterior à v8.0, incluindo qualquer um listado em v8.5.

Versão 8.2.0 Alterações interruptivas

A versão 8.2.0 do EF Core Provider não introduz diretamente nenhuma alteração significativa. No entanto, o driver .NET/C# subjacente introduz muitas alterações potencialmente significativas no v3.0 versão, o que pode afetar seu aplicação. Para saber mais sobre as alterações de ruptura na v3.0 do driver .NET/C#, consulte a atualização para a versão .30 na documentação do driver .NET/C#.

Versão 8.1.0 Alterações interruptivas

  • Atualizou o EF Core Provider para executar todas as alterações como transações MongoDB . Se o seu aplicação usar o MongoDB Server anterior à v5.0, ou não for executado em um conjunto de réplicas, você deverá fazer as seguintes alterações no seu aplicação:

    • Se seu aplicação estiver configurado para uma versão do MongoDB Server anterior à v5.0, você deve atualizar para o MongoDB Server v5.0 ou posterior.

    • Se seu aplicação for executado em um servidor autônomo , você deverá reconfigurar seu servidor autônomo para um conjunto de réplica de instância única. Para saber mais sobre como reconfigurar seu servidor autônomo , consulte Converter um mongod autogerenciado standalone em um conjunto de réplicas no manual do MongoDB Server .

    • Se seu aplicação for executado em um ambiente de contêiner, alterne para um contêiner de conjunto de réplicas de instância única, se houver um disponível.

    Para evitar problemas de snapshots durante as transações, chame o método EnsureCreated() ou EnsureCreatedAsync() durante a inicialização do aplicação , em vez de criar a collection ou o banco de dados de dados implicitamente.

    Observação

    A chamada do EnsureCreated() EnsureCreatedAsync() método ou gera um erro se o seu aplicação estiver sendo executado em um cluster compartilhado . Os aplicativos executados em clusters gratuitos e compartilhados não devem chamar esses métodos.

    Se você não quiser garantir uma simultaneidade otimista com transações, poderá desativar as transações automáticas definindo Database.AutoTransactionBehavior = AutoTrasactionBehavior.Never na DbContext subclasse durante a configuração do aplicação .

  • O formato de armazenamento GUID padrão foi alterado do formato CSharpLegacy binário para o formato Standard . Se seu banco de dados de dados contiver GUIDs existentes que não estejam no formato Standard , recomendamos convertê-los no formato Standard .

  • O CamelCaseElementNameConvention converte as letras maiúsculas e minúsculas de entidades de propriedade com base no nome da propriedade em vez do nome da classe . Se seu aplicação usa o CamelCaseElementNameConvention, as letras maiúsculas e minúsculas dos dados podem mudar.

Para obter mais informações sobre as alterações significativas nesta versão, consulte as Alterações significativas seção do repositório do provedor no Github.

Voltar

NOVIDADES