Ograniczenia dostawcy bazy danych SQLite EF Core

  • Artykuł

Dostawca SQLite ma szereg ograniczeń migracji. Większość tych ograniczeń wynika z ograniczeń w bazowym aucie bazy danych SQLite i nie jest specyficzna dla programu EF.

Ograniczenia modelowania

Wspólna biblioteka relacyjna (współdzielona przez dostawców relacyjnych baz danych platformy Entity Framework) definiuje interfejsy API do modelowania pojęć, które są wspólne dla większości aparatów relacyjnych baz danych. Kilka z tych pojęć nie jest obsługiwanych przez dostawcę SQLite.

  • Schematy
  • Sekwencje

Ograniczenia zapytań

SqLite nie obsługuje natywnie następujących typów danych. Program EF Core może odczytywać i zapisywać wartości tych typów, a wykonywanie zapytań o równość (where e.Property == value) jest również obsługiwane. Inne operacje, takie jak porównanie i kolejność, będą wymagały oceny na kliencie.

  • DateTimeOffset
  • Dziesiętne
  • przedział_czasu
  • UInt64

DateTimeOffsetZamiast polecenia zalecamy używanie wartości DateTime. Podczas obsługi wielu stref czasowych zalecamy przekonwertowanie wartości na utc przed zapisaniem, a następnie przekonwertowanie z powrotem na odpowiednią strefę czasową.

Typ Decimal zapewnia wysoki poziom dokładności. Jeśli jednak nie potrzebujesz tego poziomu dokładności, zalecamy użycie podwójnej wartości. Możesz użyć konwertera wartości, aby nadal używać liczby dziesiętnej w klasach.

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

Ograniczenia migracji

Aparat bazy danych SQLite nie obsługuje wielu operacji schematu obsługiwanych przez większość innych relacyjnych baz danych. Jeśli spróbujesz zastosować jedną z nieobsługiwanych operacji do bazy danych SQLite, zostanie zgłoszony element NotSupportedException .

Ponowna kompilacja zostanie podjęta w celu wykonania pewnych operacji. Ponowne kompilacje są możliwe tylko w przypadku artefaktów bazy danych, które są częścią modelu EF Core. Jeśli artefakt bazy danych nie jest częścią modelu — na przykład jeśli został utworzony ręcznie wewnątrz migracji — NotSupportedException jest on nadal zgłaszany.

Operacja Obsługiwane?
AddCheckConstraint ✔ (ponowne kompilowanie)
AddColumn ✔
AddForeignKey ✔ (ponowne kompilowanie)
AddPrimaryKey ✔ (ponowne kompilowanie)
AddUniqueConstraint ✔ (ponowne kompilowanie)
AlterColumn ✔ (ponowne kompilowanie)
Createindex ✔
Createtable ✔
DropCheckConstraint ✔ (ponowne kompilowanie)
DropColumn ✔ (ponowne kompilowanie)
DropForeignKey ✔ (ponowne kompilowanie)
Dropindex ✔
DropPrimaryKey ✔ (ponowne kompilowanie)
Droptable ✔
DropUniqueConstraint ✔ (ponowne kompilowanie)
Zmień nazwękolumny ✔
Zmień nazwę indeksu ✔ (ponowne kompilowanie)
Zmień nazwę tabeli ✔
Upewnij się, ŻeSchema ✔ (no-op)
DropSchema ✔ (no-op)
Insert ✔
Aktualizuj ✔
Usuń ✔

Obejście ograniczeń migracji

Niektóre z tych ograniczeń można obejść, ręcznie pisząc kod w migracjach, aby przeprowadzić ponowną kompilację. Ponowne kompilowanie tabeli obejmuje utworzenie nowej tabeli, skopiowanie danych do nowej tabeli, usunięcie starej tabeli, zmiana nazwy nowej tabeli. Aby wykonać niektóre z tych kroków, należy użyć Sql(string) metody .

Aby uzyskać więcej informacji, zobacz Artykuł Making Other Kinds Of Table Schema Changes in the SQLite documentation (Wprowadzanie innych rodzajów zmian schematu tabeli w dokumentacji SQLite).

Ograniczenia skryptu idempotentnego

W przeciwieństwie do innych baz danych SQLite nie zawiera języka proceduralnego. W związku z tym nie ma możliwości wygenerowania logiki if-then wymaganej przez skrypty migracji idempotentnej.

Jeśli znasz ostatnią migrację zastosowaną do bazy danych, możesz wygenerować skrypt z tej migracji do najnowszej migracji.

dotnet ef migrations script CurrentMigration

W przeciwnym razie zalecamy użycie polecenia dotnet ef database update w celu zastosowania migracji. Podczas uruchamiania polecenia można określić plik bazy danych.

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

Zobacz też