Limitações do provedor de banco de dados SQL EF Core

O provedor SQLite tem várias limitações de migrações. A maioria dessas limitações é resultado de limitações no mecanismo de banco de dados SQLite subjacente e não são específicas do EF.

Limitações de modelagem

A biblioteca relacional comum (compartilhada por provedores de banco de dados relacional EF Core) define APIs para conceitos de modelagem que são comuns à maioria dos mecanismos de banco de dados relacional. Alguns desses conceitos não são suportados pelo provedor SQLite.

• Esquemas
• Sequências
• Tokens de simultaneidade gerados por banco de dados (consulte a documentação)

Limitações de consulta

O SQLite não suporta nativamente os seguintes tipos de dados. EF Core pode ler e gravar valores desses tipos, e a consulta por igualdade (where e.Property == value) também é suportada. Outras operações, no entanto, como comparação e encomenda exigirão avaliação no cliente.

• DateTimeOffset
• decimal
• TimeSpan
• ulong

Em vez de DateTimeOffset, recomendamos usar valores DateTime. Ao lidar com vários fusos horários, recomendamos converter os valores em UTC antes de salvar e, em seguida, converter novamente para o fuso horário apropriado.

O tipo decimal fornece um alto nível de precisão. Se você não precisa desse nível de precisão, no entanto, recomendamos usar double em vez disso. Você pode usar um conversor de valor para continuar usando decimal em suas classes.

modelBuilder.Entity<MyEntity>()
    .Property(e => e.DecimalProperty)
    .HasConversion<double>();

Limitações das migrações

O mecanismo de banco de dados SQLite não suporta várias operações de esquema que são suportadas pela maioria dos outros bancos de dados relacionais. Se você tentar aplicar uma das operações sem suporte a um banco de dados SQLite, uma NotSupportedException será lançada.

Será tentada uma reconstrução para executar determinadas operações. As reconstruções só são possíveis para artefatos de banco de dados que fazem parte do seu modelo EF Core. Se um artefato de banco de dados não fizer parte do modelo - por exemplo, se foi criado manualmente dentro de uma migração - um NotSupportedException ainda será gerado.

Soluções para ultrapassar limitações de migrações

Você pode contornar algumas dessas limitações escrevendo manualmente código em suas migrações para executar uma reconstrução. As reconstruções de tabela envolvem a criação de uma nova tabela, a cópia de dados para a nova tabela, a eliminação da tabela antiga e a renomeação da nova tabela. Você precisará usar o método Sql para executar algumas dessas etapas.

Consulte Fazendo outros tipos de alterações de esquema de tabela na documentação do SQLite para obter mais detalhes.

Limitações idempotentes de script

Ao contrário de outros bancos de dados, o SQLite não inclui uma linguagem processual. Por isso, não há como gerar a lógica if-then exigida pelos scripts de migração idempotentes.

Se você souber a última migração aplicada a um banco de dados, poderá gerar um script dessa migração para a migração mais recente.

dotnet ef migrations script CurrentMigration

Caso contrário, recomendamos o uso de dotnet ef database update para aplicar migrações. Você pode especificar o arquivo de banco de dados ao executar o comando.

dotnet ef database update --connection "Data Source=My.db"

Proteção contra migrações simultâneas

O EF9 introduziu um mecanismo de bloqueio de migração para proteger contra execuções de migração concorrentes. Ao contrário do SQL Server, que utiliza um bloqueio de aplicação ao nível da sessão (sp_getapplock) que é automaticamente libertado quando a ligação fecha, o SQLite não tem bloqueios de aplicação incorporados. O EF Core, em vez disso, cria uma __EFMigrationsLock tabela e insere uma linha para adquirir o bloqueio.

Gestão de bloqueios abandonados

Se a aplicação terminar inesperadamente (por exemplo, o processo for interrompido durante a migração), a linha de bloqueio na __EFMigrationsLock tabela pode não ser limpa. Isto impede que qualquer migração subsequente seja concluída, pois cada tentativa espera indefinidamente que o bloqueio seja libertado.

Para resolver um bloqueio abandonado, retire a __EFMigrationsLock tabela da base de dados:

DROP TABLE "__EFMigrationsLock";

Ou, alternativamente, eliminar todas as linhas da tabela:

DELETE FROM "__EFMigrationsLock";

Após a libertação da eclusão, as operações subsequentes de migração decorrem normalmente. A tabela é automaticamente recriada conforme necessário.

Ver também

• Microsoft.Data.Sqlite Limitações de Operações Assíncronas
• Microsoft. Data.sqlite ADO.NET limitações