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

SQLITE_ERROR: ошибка логики SQL

Общий код ошибки SQLite: ошибка синтаксиса, отсутствующая таблица или столбец, или другая проблема с SQL. Настоящая причина указана в сообщении об ошибке, а не в коде.

Код результата
SQLITE_ERROR
Имя
1
Категория
Основные коды результатов
Сообщение об ошибке
SQL logic error

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

SQLITE_ERROR (1) — код, который SQLite использует, когда не применяется более конкретный код. Почти каждая ошибка в самом SQL приводит сюда: опечатка, таблица или столбец, который не существует, таблица, которая уже существует, неверное количество значений. Общий текст — SQL logic error; сообщение от sqlite3_errmsg() говорит, что именно пошло не так, например no such table: users, no such column: emial, near "FORM": syntax error или table users already exists.

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

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

  • Синтаксическая ошибка: near "...": syntax error указывает на токен, на котором произошла ошибка разбора.
  • no such table: имя таблицы написано с ошибкой, таблица находится в прикреплённой базе данных, имя которой вы не указали, или программа открыла не тот — часто новый и пустой — файл базы данных, который вы предполагали.
  • no such column: неверно написанный столбец или строковый литерал, написанный в двойных кавычках, который SQLite воспринял как имя столбца.
  • table ... already exists из CREATE TABLE без IF NOT EXISTS.
  • Использование синтаксиса или функций, которые ваша версия SQLite уже не поддерживает, например RETURNING (3.35) или оконные функции (3.25).

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

  1. Прочитайте полное сообщение и исправьте то, что в нем указано. Проверьте, к какой схеме вы действительно подключены:

    SELECT name, type FROM sqlite_schema ORDER BY name;
    PRAGMA table_info(users);
  2. Если таблицы нет, проверьте, какой файл открыт. Относительный путь открывает файл относительно рабочей директории процесса, а открытие несуществующего пути создаёт новую пустую базу данных.

    PRAGMA database_list;
  3. Используйте одинарные кавычки для строковых литералов и двойные кавычки только для идентификаторов.

    SELECT * FROM users WHERE status = 'active';
  4. Проверяйте версию библиотеки, если новый синтаксис не поддерживается.

    SELECT sqlite_version();

Безопасное воспроизведение

SELECT * FROM no_such_table;   -- Parse error: no such table: no_such_table

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

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

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

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

Работа с SQLite в SQLly

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