Ограничения поставщика базы данных SQLite EF Core

  • Статья

Поставщик SQLite имеет ряд ограничений миграции. Большинство этих ограничений являются результатом ограничений в базовом ядре СУБД SQLite и не относятся к EF.

Ограничения моделирования

Общая реляционная библиотека (совместно с поставщиками реляционных баз данных Entity Framework) определяет API для моделирования концепций, которые являются общими для большинства реляционных ядр субД. Несколько этих понятий не поддерживаются поставщиком SQLite.

  • Схемы
  • Последовательности

Ограничения запросов

SQLite не поддерживает следующие типы данных. EF Core может считывать и записывать значения этих типов и запрашивать равенство (where e.Property == value) также поддерживается. Однако для других операций, таких как сравнение и упорядочение, потребуется оценка на клиенте.

  • DateTimeOffset
  • Decimal
  • TimeSpan
  • UInt64

Вместо этого DateTimeOffsetрекомендуется использовать значения DateTime. При обработке нескольких часовых поясов рекомендуется преобразовать значения в формате UTC перед сохранением, а затем вернуться в соответствующий часовой пояс.

Тип Decimal обеспечивает высокий уровень точности. Если вам не нужен этот уровень точности, рекомендуется использовать двойной. Для продолжения использования десятичного значения в классах можно использовать преобразователь значений.

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

Ограничения миграции

Ядро СУБД SQLite не поддерживает ряд операций схемы, поддерживаемых большинством других реляционных баз данных. Если вы пытаетесь применить одну из неподдерживаемых операций к базе данных SQLite, NotSupportedException будет создано исключение.

Для выполнения определенных операций будет предпринята попытка перестроения. Перестроение возможно только для артефактов базы данных, которые являются частью модели EF Core. Если артефакт базы данных не является частью модели, например, если он был создан вручную внутри миграции, NotSupportedException то возникает исключение.

Операция Поддерживается?
AddCheckConstraint ✔ (перестроение)
AddColumn ✔
AddForeignKey ✔ (перестроение)
AddPrimaryKey ✔ (перестроение)
AddUniqueConstraint ✔ (перестроение)
AlterColumn ✔ (перестроение)
CreateIndex ✔
CreateTable ✔
DropCheckConstraint ✔ (перестроение)
DropColumn ✔ (перестроение)
DropForeignKey ✔ (перестроение)
DropIndex ✔
DropPrimaryKey ✔ (перестроение)
DropTable ✔
DropUniqueConstraint ✔ (перестроение)
RenameColumn ✔
ПереименоватьIndex ✔ (перестроение)
Переименование ✔
ОбеспечениеSchema ✔ (no-op)
DropSchema ✔ (no-op)
Insert ✔
Обновить ✔
Удаление ✔

Обходное решение для ограничений миграции

Чтобы выполнить перестроение, можно обойти некоторые из этих ограничений вручную, написав код в миграции. Перестроения таблиц включают создание новой таблицы, копирование данных в новую таблицу, удаление старой таблицы, переименование новой таблицы. Для выполнения некоторых этих действий вам потребуется использовать Sql(string) метод.

Дополнительные сведения см . в статье о внесении изменений в схему таблиц других типов в документации SQLite.

Ограничения сценариев idempotent

В отличие от других баз данных, SQLite не включает процедурный язык. Из-за этого невозможно создать логику if-then, необходимую скриптам идемпотентной миграции.

Если вы знаете, что последняя миграция применена к базе данных, можно создать скрипт из этой миграции до последней миграции.

dotnet ef migrations script CurrentMigration

В противном случае рекомендуется применить dotnet ef database update миграции. При выполнении команды можно указать файл базы данных.

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

См. также