// справочник ошибок SQLite

SQLITE_SCHEMA: схема базы данных изменилась

Подготовленный оператор стал недействительным, потому что после его подготовки изменилась схема, а SQLite не смог подготовить его заново.

Код результата
SQLITE_SCHEMA
Имя
17
Категория
Основные коды результатов
Сообщение об ошибке
database schema has changed

Что это значит

SQLITE_SCHEMA (17) означает, что схема изменилась между подготовкой запроса и его выполнением, например, другое соединение добавило индекс или изменило таблицу. Запросы, подготовленные с sqlite3_prepare_v2() (что используют почти все современные привязки), автоматически переподготавливаются, по умолчанию до 50 раз, поэтому вы видите эту ошибку только с устаревшим sqlite3_prepare() или когда повторная подготовка всё время не удаётся.

Распространённые причины

  • Использование устаревшего sqlite3_prepare() интерфейса, который не переподготавливается при изменениях схемы.
  • Другое соединение постоянно изменяет схему, пока запросы готовятся и выполняются.
  • Изменение схемы, которое делает повторно подготовленный оператор недействительным, например удаление используемого столбца.

Как исправить

  1. Подготавливайте запросы с sqlite3_prepare_v2() или sqlite3_prepare_v3() поэтому SQLite подготовит их заново за вас.

  2. Если ошибка приходит из кэша операторов, завершите кэшированный оператор и подготовьте его заново после изменения схемы.

  3. Выполняйте миграции схемы, когда приложение простаивает, а не когда другие соединения выполняют операторы.

Связанные ошибки

Больше ошибок основных кодов результатов

Код и текст сообщения взяты из Документация по кодам результатов и ошибок SQLite. Смотрите весь Список ошибок SQLite или поиск по всем ошибкам баз данных.

// меньше ошибок, быстрее исправления

Работа с SQLite в SQLly

Нативный SQL-клиент для macOS, Windows и Linux с IntelliSense, который знает вашу схему, предохранителями для рискованных запросов и понятными сообщениями об ошибках — для SQLite и других баз данных, которые вы используете.