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

Коды ошибок SQLite

Все коды результатов SQLite из официального списка, основные и расширенные, с текстом sqlite3_errstr() возвращает для каждого основного кода. У тех, с которыми вы, скорее всего, столкнётесь, есть отдельная страница с причинами и способами исправления.

Чтение ошибки SQLite

Функции SQLite возвращают целочисленный код результата. Нижние восемь битов — это основной код, например SQLITE_BUSY (5). Расширенные коды добавляют детали в старшие биты: SQLITE_BUSY_SNAPSHOT это 517, что равно 5 + 2 × 256. Расширенные коды возвращаются, когда они включены с помощью sqlite3_extended_result_codes() или читаются с помощью sqlite3_extended_errcode().

Сообщение, которое показывает программа, обычно поступает из sqlite3_errmsg(), которое может быть более конкретным, чем общее сообщение, например UNIQUE constraint failed: users.email вместо constraint failed.

Языковые привязки оборачивают эти коды: в Python это sqlite3 вызывает исключения OperationalError или IntegrityError и, начиная с Python 3.11, предоставляет sqlite_errorcode и sqlite_errorname в исключении.

Все ошибки SQLite в этом справочнике

105 кодов, 40 с полным описанием (со ссылкой). Коды и сообщения взяты из Документация по кодам результатов и ошибок SQLite.

Основные коды результатов

КодЗначение
SQLITE_OK 0 не ошибка
SQLITE_ERROR Ошибка логики SQL 1 Ошибка логики SQL
SQLITE_INTERNAL 2
SQLITE_PERM доступ запрещён 3 доступ запрещён
SQLITE_ABORT запрос прерван 4 запрос прерван
SQLITE_BUSY база данных заблокирована 5 база данных заблокирована
SQLITE_LOCKED таблица базы данных заблокирована 6 таблица базы данных заблокирована
SQLITE_NOMEM недостаточно памяти 7 недостаточно памяти
SQLITE_READONLY попытка записи в базу данных, доступную только для чтения 8 попытка записи в базу данных, доступную только для чтения
SQLITE_INTERRUPT прервано 9 прервано
SQLITE_IOERR ошибка ввода-вывода диска 10 ошибка ввода-вывода диска
SQLITE_CORRUPT образ диска базы данных поврежден 11 образ диска базы данных поврежден
SQLITE_NOTFOUND 12 неизвестная операция
SQLITE_FULL база данных или диск заполнены 13 база данных или диск заполнены
SQLITE_CANTOPEN не удалось открыть файл базы данных 14 не удалось открыть файл базы данных
SQLITE_PROTOCOL протокол блокировки 15 протокол блокировки
SQLITE_EMPTY 16
SQLITE_SCHEMA схема базы данных изменилась 17 схема базы данных изменилась
SQLITE_TOOBIG строка или BLOB слишком велики 18 строка или BLOB слишком велики
SQLITE_CONSTRAINT нарушение ограничения 19 нарушение ограничения
SQLITE_MISMATCH несоответствие типов данных 20 несоответствие типов данных
SQLITE_MISUSE неправильный параметр или другое неправильное использование API 21 неправильный параметр или другое неправильное использование API
SQLITE_NOLFS 22
SQLITE_AUTH доступ запрещён 23 доступ запрещён
SQLITE_FORMAT 24
SQLITE_RANGE индекс столбца вне диапазона 25 индекс столбца вне диапазона
SQLITE_NOTADB файл не является базой данных 26 файл не является базой данных
SQLITE_NOTICE 27 сообщение уведомления
SQLITE_WARNING 28 предупреждающее сообщение
SQLITE_ROW 100 доступна ещё одна строка
SQLITE_DONE 101 больше строк нет

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

КодЗначение
SQLITE_OK_LOAD_PERMANENTLY 256
SQLITE_ERROR_MISSING_COLLSEQ нет такой последовательности сортировки 257 нет такой последовательности сортировки: unicode_ci
SQLITE_BUSY_RECOVERY другой процесс восстанавливает WAL 261 база данных заблокирована
SQLITE_LOCKED_SHAREDCACHE запись заблокирована в общем кэше 262 таблица базы данных заблокирована
SQLITE_READONLY_RECOVERY 264
SQLITE_IOERR_READ 266
SQLITE_CORRUPT_VTAB 267
SQLITE_CANTOPEN_NOTEMPDIR 270
SQLITE_CONSTRAINT_CHECK Нарушено ограничение CHECK 275 Нарушено ограничение CHECK: price_positive
SQLITE_AUTH_USER 279
SQLITE_NOTICE_RECOVER_WAL 283
SQLITE_WARNING_AUTOINDEX 284
SQLITE_ERROR_RETRY 513
SQLITE_ABORT_ROLLBACK оператор прерван командой ROLLBACK 516 отмена из-за ROLLBACK
SQLITE_BUSY_SNAPSHOT устаревшее чтение не может стать записью 517 база данных заблокирована
SQLITE_LOCKED_VTAB 518
SQLITE_READONLY_CANTLOCK 520
SQLITE_IOERR_SHORT_READ чтение вернуло меньше байт 522 ошибка ввода-вывода диска
SQLITE_CORRUPT_SEQUENCE 523
SQLITE_CANTOPEN_ISDIR путь является каталогом 526 не удалось открыть файл базы данных
SQLITE_CONSTRAINT_COMMITHOOK 531
SQLITE_NOTICE_RECOVER_ROLLBACK 539
SQLITE_ERROR_SNAPSHOT 769
SQLITE_BUSY_TIMEOUT истекло время ожидания блокировки файла 773 база данных заблокирована
SQLITE_READONLY_ROLLBACK не удается выполнить откат горячего журнала 776 попытка записи в базу данных, доступную только для чтения
SQLITE_IOERR_WRITE 778
SQLITE_CORRUPT_INDEX запись индекса отсутствует 779 образ диска базы данных поврежден
SQLITE_CANTOPEN_FULLPATH 782
SQLITE_CONSTRAINT_FOREIGNKEY Нарушено ограничение внешнего ключа 787 Нарушено ограничение внешнего ключа
SQLITE_READONLY_DBMOVED файл базы данных был перемещен во время открытия 1032 попытка записи в базу данных, доступную только для чтения
SQLITE_IOERR_FSYNC 1034
SQLITE_CANTOPEN_CONVPATH 1038
SQLITE_CONSTRAINT_FUNCTION 1043
SQLITE_READONLY_CANTINIT 1288
SQLITE_IOERR_DIR_FSYNC 1290
SQLITE_CANTOPEN_DIRTYWAL 1294
SQLITE_CONSTRAINT_NOTNULL Нарушено ограничение NOT NULL 1299 Нарушено ограничение NOT NULL: users.name
SQLITE_READONLY_DIRECTORY не удаётся создать файл журнала 1544 попытка записи в базу данных, доступную только для чтения
SQLITE_IOERR_TRUNCATE 1546
SQLITE_CONSTRAINT_PRIMARYKEY Нарушено ограничение PRIMARY KEY 1555 Нарушено ограничение UNIQUE: orders.id
SQLITE_IOERR_FSTAT 1802
SQLITE_CONSTRAINT_TRIGGER RAISE() в триггере прервал его выполнение 1811 нарушение ограничения
SQLITE_IOERR_UNLOCK 2058
SQLITE_CONSTRAINT_UNIQUE Нарушено ограничение UNIQUE 2067 Нарушено ограничение UNIQUE: users.email
SQLITE_IOERR_RDLOCK 2314
SQLITE_CONSTRAINT_VTAB 2323
SQLITE_IOERR_DELETE 2570
SQLITE_CONSTRAINT_ROWID 2579
SQLITE_IOERR_BLOCKED 2826
SQLITE_CONSTRAINT_PINNED 2835
SQLITE_IOERR_NOMEM 3082
SQLITE_CONSTRAINT_DATATYPE значение не соответствует столбцу STRICT 3091 невозможно сохранить значение TEXT в столбце INTEGER t.qty
SQLITE_IOERR_ACCESS 3338
SQLITE_IOERR_CHECKRESERVEDLOCK 3594
SQLITE_IOERR_LOCK 3850
SQLITE_IOERR_CLOSE 4106
SQLITE_IOERR_DIR_CLOSE 4362
SQLITE_IOERR_SHMOPEN 4618
SQLITE_IOERR_SHMSIZE 4874
SQLITE_IOERR_SHMLOCK 5130
SQLITE_IOERR_SHMMAP 5386
SQLITE_IOERR_SEEK 5642
SQLITE_IOERR_DELETE_NOENT 5898
SQLITE_IOERR_MMAP 6154
SQLITE_IOERR_GETTEMPPATH 6410
SQLITE_IOERR_CONVPATH 6666
SQLITE_IOERR_VNODE 6922
SQLITE_IOERR_AUTH 7178
SQLITE_IOERR_BEGIN_ATOMIC 7434
SQLITE_IOERR_COMMIT_ATOMIC 7690
SQLITE_IOERR_ROLLBACK_ATOMIC 7946
SQLITE_IOERR_DATA 8202
SQLITE_IOERR_CORRUPTFS 8458
// один клиент, все движки

Более быстрый способ работы с SQLite

SQLly — это нативный SQL-клиент для macOS, Windows и Linux с поддержкой IntelliSense, учитывающей схему базы данных, и защитой от опасных операций.