Omezení zprostředkovatele databáze SQLite EF Core
Poskytovatel SQLite má řadu omezení migrace. Většina těchto omezení je výsledkem omezení základního databázového stroje SQLite a nejsou specifická pro EF.
Omezení modelování
Společná relační knihovna (sdílená poskytovateli relačních databází Entity Framework) definuje rozhraní API pro koncepty modelování, které jsou společné pro většinu relačních databázových strojů. Poskytovatel SQLite nepodporuje několik těchto konceptů.
- Schémata
- Sekvence
Omezení dotazů
SQLite nativně nepodporuje následující datové typy. EF Core může číst a zapisovat hodnoty těchto typů a dotazování na rovnost (where e.Property == value
) je také podporováno. Jiné operace, jako je například porovnání a řazení, však budou vyžadovat vyhodnocení klienta.
- DateTimeOffset
- Desetinná čárka
- TimeSpan
- UInt64
DateTimeOffset
Místo toho doporučujeme použít hodnoty DateTime. Při zpracování více časových pásem doporučujeme hodnoty před uložením a následnou převodem zpět na příslušné časové pásmo převést na UTC.
Typ Decimal
poskytuje vysokou úroveň přesnosti. Pokud ale tuto úroveň přesnosti nepotřebujete, doporučujeme místo toho použít dvojité. Pomocí převaděče hodnot můžete ve třídách pokračovat v používání desetinných míst.
modelBuilder.Entity<MyEntity>()
.Property(e => e.DecimalProperty)
.HasConversion<double>();
Omezení migrace
Databázový stroj SQLite nepodporuje řadu operací schématu podporovaných většinou jiných relačních databází. Pokud se pokusíte použít jednu z nepodporovaných operací na databázi SQLite, NotSupportedException
vyvolá se vyvolá.
Opětovné sestavení se pokusí provést určité operace. Opětovné sestavení je možné pouze pro artefakty databáze, které jsou součástí modelu EF Core. Pokud artefakt databáze není součástí modelu , například pokud byl vytvořen ručně uvnitř migrace, NotSupportedException
je stále vyvolán.
Operace | Podporováno? |
---|---|
AddCheckConstraint | ✔ (opětovné sestavení) |
AddColumn | ✔ |
AddForeignKey | ✔ (opětovné sestavení) |
AddPrimaryKey | ✔ (opětovné sestavení) |
AddUniqueConstraint | ✔ (opětovné sestavení) |
AlterColumn | ✔ (opětovné sestavení) |
CreateIndex | ✔ |
Createtable | ✔ |
DropCheckConstraint | ✔ (opětovné sestavení) |
DropColumn | ✔ (opětovné sestavení) |
DropForeignKey | ✔ (opětovné sestavení) |
DropIndex | ✔ |
DropPrimaryKey | ✔ (opětovné sestavení) |
DropTable | ✔ |
DropUniqueConstraint | ✔ (opětovné sestavení) |
PřejmenovatSloupce | ✔ |
RenameIndex | ✔ (opětovné sestavení) |
Přejmenovat tabulku | ✔ |
Ujistěte se, žeSchema | ✔ (no-op) |
DropSchema | ✔ (no-op) |
Vložit | ✔ |
Aktualizovat | ✔ |
Odstranění | ✔ |
Alternativní řešení pro omezení migrace
Některá z těchto omezení můžete obejít ručním napsáním kódu v migracích za účelem opětovného sestavení. Opětovné sestavení tabulky zahrnuje vytvoření nové tabulky, kopírování dat do nové tabulky, vyřazení staré tabulky a přejmenování nové tabulky. K provedení některých z těchto kroků budete muset použít Sql(string)
metodu.
Další podrobnosti najdete v tématu Vytváření dalších typů změn schématu tabulky v dokumentaci SQLite.
Omezení idempotentního skriptu
Na rozdíl od jiných databází neobsahuje SQLite procedurální jazyk. Z tohoto důvodu neexistuje způsob, jak vygenerovat logiku if-then vyžadovanou skripty migrace idempotentní.
Pokud znáte poslední migraci použitou na databázi, můžete z této migrace na nejnovější migraci vygenerovat skript.
dotnet ef migrations script CurrentMigration
V opačném případě doporučujeme použít dotnet ef database update
migrace. Při spuštění příkazu můžete zadat soubor databáze.
dotnet ef database update --connection "Data Source=My.db"