Коды ошибок 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_CANTOPEN_SYMLINK
|
1550
|
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, учитывающей схему базы данных, и защитой от опасных операций.