// Référence des erreurs SQLite

SQLITE_SCHEMA : le schéma de la base de données a changé

Une instruction préparée est devenue invalide car le schéma a changé après sa préparation, et SQLite n'a pas pu la re-préparer.

Code de résultat
SQLITE_SCHEMA
Nom
17
Catégorie
Codes de résultat principaux
Message d'erreur
database schema has changed

Ce que cela signifie

SQLITE_SCHEMA (17) signifie que le schéma a changé entre la préparation d'une instruction et son exécution, par exemple une autre connexion a ajouté un index ou modifié une table. Les instructions préparées avec sqlite3_prepare_v2() (ce que presque toutes les liaisons modernes utilisent) sont automatiquement re-préparées, jusqu'à 50 fois par défaut, donc vous ne voyez cette erreur qu'avec l'ancien sqlite3_prepare() ou lorsque la re-préparation échoue continuellement.

Causes courantes

  • Utilisation de l'ancienne sqlite3_prepare() interface, qui ne re-prépare pas lors des changements de schéma.
  • Une autre connexion modifiant constamment le schéma pendant que les instructions sont préparées et exécutées.
  • Un changement de schéma qui invalide l'instruction re-préparée, par exemple la suppression d'une colonne qu'elle utilise.

Comment le corriger

  1. Préparez des instructions avec sqlite3_prepare_v2() ou sqlite3_prepare_v3() afin que SQLite les re-prépare pour vous.

  2. Si vous obtenez cela depuis un cache d'instructions, finalisez l'instruction en cache et préparez-la à nouveau après une modification du schéma.

  3. Exécutez les migrations de schéma quand l'application est inactive, et non pendant que d'autres connexions exécutent des instructions.

Erreurs liées

Plus d'erreurs de codes de résultat principaux

Le code et le texte du message sont issus de documentation des codes de résultat et d'erreur SQLite. Parcourir la liste complète Liste des erreurs SQLite ou Rechercher toutes les erreurs de base de données.

// moins d'erreurs, corrections plus rapides

Travailler sur SQLite dans SQLly

Un client SQL natif pour macOS, Windows et Linux avec IntelliSense conscient du schéma, des garde-fous pour les instructions risquées et des messages d'erreur clairs, pour SQLite et les autres bases de données que vous utilisez.