SQLite EF Core-Datenbank-Anbieter-Einschränkungen

Der SQLite-Anbieter hat eine Reihe von Migrationseinschränkungen. Die meisten dieser Einschränkungen ergeben sich aus Einschränkungen im zugrunde liegenden SQLite-Datenbankmodul und sind nicht spezifisch für EF.

Modellierungseinschränkungen

Die gemeinsame relationale Bibliothek (die von den Anbietern relationaler Datenbanken von Entity Framework gemeinsam genutzt wird) definiert APIs für Modellierungskonzepte, die den meisten relationalen Datenbank-Engines gemeinsam sind. Einige dieser Konzepte werden vom SQLite-Anbieter nicht unterstützt.

  • Schemas
  • Sequenzen

Abfrageeinschränkungen

SQLite unterstützt die folgenden Datentypen nicht nativ. EF Core kann Werte dieser Typen lesen und schreiben, und die Abfrage nach Gleichheit (where e.Property == value) wird ebenfalls unterstützt. Andere Vorgänge, z. B. Vergleich und Sortierung, erfordern jedoch eine Auswertung auf dem Client.

  • DateTimeOffset
  • Decimal
  • TimeSpan
  • UInt64

Anstelle von DateTimeOffset empfehlen wir die Verwendung von DateTime-Werten. Wenn Sie mit mehreren Zeitzonen arbeiten, empfehlen wir Ihnen, die Werte vor dem Speichern in UTC zu konvertieren und dann in die entsprechende Zeitzone zurück zu konvertieren.

Der Decimal Typ bietet eine hohe Genauigkeit. Wenn Sie diese Präzision jedoch nicht benötigen, empfehlen wir Ihnen, die doppelte Zahl zu verwenden. Sie können einen Wertkonverter verwenden, um die Dezimalzahl in Ihren Klassen fortzusetzen.

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

Migrationseinschränkungen

Das SQLite-Datenbankmodul unterstützt keine Anzahl von Schemavorgängen, die von den meisten anderen relationalen Datenbanken unterstützt werden. Wenn Sie versuchen, einen der nicht unterstützten Vorgänge auf eine SQLite-Datenbank anzuwenden, wird ein NotSupportedException ausgelöst.

Es wird versucht, eine Neuerstellung durchzuführen, um bestimmte Vorgänge auszuführen. Neuerstellungen sind nur für Datenbankartefakte möglich, die Teil Ihres EF Core-Modells sind. Wenn ein Datenbank-Artefakt nicht Teil des Modells ist – zum Beispiel, wenn es manuell im Rahmen einer Migration erstellt wurde –, wird trotzdem eine Meldung NotSupportedException ausgegeben.

Vorgang Unterstützt?
AddCheckConstraint ✔ (rebuild)
AddColumn
AddForeignKey ✔ (rebuild)
AddPrimaryKey ✔ (rebuild)
AddUniqueConstraint ✔ (rebuild)
AlterColumn ✔ (rebuild)
CreateIndex
CreateTable
DropCheckConstraint ✔ (rebuild)
DropColumn ✔ (rebuild)
DropForeignKey ✔ (rebuild)
DropIndex
DropPrimaryKey ✔ (rebuild)
DropTable
DropUniqueConstraint ✔ (rebuild)
RenameColumn
RenameIndex ✔ (rebuild)
RenameTable
EnsureSchema ✔ (no-op)
DropSchema ✔ (no-op)
„Insert“
Aktualisieren
Entf

Migrationseinschränkungen Problemumgehung

Sie können einige dieser Einschränkungen umgehen, indem Sie manuell Code in Ihre Migrationen schreiben, um einen Neuaufbau durchzuführen. Um eine Tabelle neu zu erstellen, müssen Sie eine neue Tabelle erstellen, die Daten in die neue Tabelle kopieren, die alte Tabelle löschen und die neue Tabelle umbenennen. Sie müssen die Sql(string)-Methode verwenden, um einige dieser Schritte auszuführen.

Weitere Informationen finden Sie unter Vornehmen anderer Arten von Tabellenschemaänderungen in der SQLite-Dokumentation.

Einschränkungen von Idempotent-Skripts

Im Gegensatz zu anderen Datenbanken enthält SQLite keine prozedurale Sprache. Aus diesem Grund gibt es keine Möglichkeit, die if-then-Logik zu generieren, die von den idempotenten Migrationsskripts benötigt wird.

Wenn Sie wissen, dass die letzte Migration auf eine Datenbank angewendet wurde, können Sie ein Skript aus dieser Migration zur neuesten Migration generieren.

dotnet ef migrations script CurrentMigration

Andernfalls wird empfohlen, dotnet ef database update zum Anwenden von Migrationen zu verwenden. Sie können die Datenbankdatei beim Ausführen des Befehls angeben.

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

Siehe auch