// SQLite-Fehlerreferenz

SQLITE_SCHEMA: Das Datenbankschema wurde geändert

Eine vorbereitete Anweisung wurde ungültig, weil sich das Schema nach ihrer Vorbereitung geändert hat und SQLite sie nicht erneut vorbereiten konnte.

Ergebniscode
SQLITE_SCHEMA
Name
17
Kategorie
Primäre Ergebniscodes
Fehlermeldung
database schema has changed

Was es bedeutet

SQLITE_SCHEMA (17) bedeutet, dass sich das Schema zwischen der Vorbereitung einer Anweisung und ihrer Ausführung geändert hat, zum Beispiel hat eine andere Verbindung einen Index hinzugefügt oder eine Tabelle geändert. Mit vorbereiteten Anweisungen sqlite3_prepare_v2() (was fast jede moderne Bindung verwendet) werden standardmäßig bis zu 50-mal automatisch neu vorbereitet, sodass du diesen Fehler nur mit der veralteten sqlite3_prepare() oder wenn die erneute Vorbereitung weiterhin fehlschlägt.

Häufige Ursachen

  • Verwendung der veralteten sqlite3_prepare() Schnittstelle, die bei Schemaänderungen nicht neu vorbereitet.
  • Eine andere Verbindung ändert das Schema ständig, während Anweisungen vorbereitet und ausgeführt werden.
  • Eine Schemaänderung, die die erneut vorbereitete Anweisung ungültig macht, zum Beispiel das Löschen einer Spalte, die sie verwendet.

Wie du es behebst

  1. Anweisungen vorbereiten mit sqlite3_prepare_v2() oder sqlite3_prepare_v3() sodass SQLite sie für dich neu vorbereitet.

  2. Wenn du das aus einem Statement-Cache hast, mach ein Finalize der zwischengespeicherten Anweisung und bereite sie nach einer Schemaänderung neu vor.

  3. Führe Schema-Migrationen durch, während die Anwendung inaktiv ist, nicht während andere Verbindungen Anweisungen ausführen.

Zugehörige Fehler

Weitere Fehler bei primären Ergebniscodes

Der Code und der Meldungstext stammen aus der SQLite-Dokumentation zu Ergebnis- und Fehlercodes. Durchstöbere die vollständige SQLite-Fehlerliste oder Jeden Datenbankfehler durchsuchen.

// weniger Fehler, schnellere Korrekturen

Arbeiten mit SQLite in SQLly

Ein nativer SQL-Client für macOS, Windows und Linux mit schemabewusstem IntelliSense, Guardrails für riskante Anweisungen und klaren Fehlermeldungen, für SQLite und die anderen Datenbanken, mit denen du arbeitest.