SQLite: коды ошибок

Код результата SQLITE_INTERRUPT указывает на то, что операция была прервана интерфейсом квадратной 3_интерруп(). См. также: SQLITE_ABORT

Код результата SQLITE_IOERR говорит, что операция не могла закончиться, потому что операционная система сообщила об ошибке I/O. Полный дисковый привод обычно дает ошибку SQLITE_FULL, а не ошибку SQLITE_IOERR. Существует множество различных расширенных кодов результатов для ошибок I/O, которые определяют конкретную операцию I/O, которая не прошла.

SQLITE_IOERR_ACCESS — расширенный код ошибки для SQLITE_IOERR, указывающий на ошибку I/O в методе доступа x на объект квадратного уровня 3_vfs.

SQLITE_IOERR_AUTH — код, предназначенный для расширения.

Код ошибки SQLITE_IOERR_BEGIN_ATOMIC указывает, что в основной операционной системе была допущена ошибка в SQLITE_FCNTL_BEGIN_ATOMIC_WRITE. Это происходит только при включении SQLITE_ENLEL_ATOMIC_WRITE, а база данных размещена на файловой системе, поддерживающей атомные записи.

Код ошибки SQLITE_IOERR_BLOKKED больше не используется.

SQLITE_IOERR_CHECRESEREEDLOCK — расширенный код ошибки для SQLITE_IOERR, указывающий на ошибку I/O в методе xCheck serverLock на квадратном объекте.

SQLITE_IOERR_CLOSE — расширенный код ошибок для SQLITE_IOERR, указывающий на ошибку I/O в рамках метода xClose на квадратном объекте.

SQLITE_IOERR_COMMIT_ATOMIC-код ошибок указывает, что в основной операционной системе была допущена ошибка в SQLITE_FCNTL_COMMIT_ATOMIC_WRITE. Это происходит только тогда, когда SQLITE_ENLED_ATOMIC_WRITE включена и база данных размещена на файловой системе, поддерживающей атомные записи.

SQLITE_IOERR_CONVPATH — расширенный код ошибки для SQLITE_IOERR, используемый только Cygwin VFS и указывающий на то, что вызов системы Cygwin_convent_path(). См. также: SQLITE_CANTOPEN_CONVPATH

Код ошибки SQLITE_IOERR_CORUPTFS — расширенный код ошибки для SQLITE_IOERR, используемый только VFS для указания того, что запрос или считывание были вызваны не запросом, не входящим в границу файла, а обычным нарушением устройства. Это часто указывает на коррумпированную файловую систему. Эта страница была в последний раз обновлена 2026-02-18:56:50Z

SQLITE_IOERR_DATA — расширенный код ошибки для SQLITE_IOERR, используемый только контрольным shim для указания на то, что контрольная сумма на странице файла базы данных неверна.

SQLITE_IOERR_DELETE — расширенный код ошибки для SQLITE_IOERR, указывающий на ошибку I/O в методе xDelete на квадратном объекте.

SQLITE_IOERR_DELETE_NOENT — расширенный код ошибки для SQLITE_IOERR, указывающий на то, что метод xDelete на объекте квадратный 3_vfs не сработал, поскольку файл, который удаляется, не существует.

Код ошибки SQLITE_IOERR_DIR_CLOSE больше не используется.

SQLITE_IOERR_DIR_FSYNC — расширенный код ошибок для SQLITE_IOERR, указывающий на ошибку I/O в слое VFS, когда он пытается использовать fsync() в каталоге. Уникс VFS пытается фсинкировать () каталоги после создания или исключения определенных файлов, чтобы убедиться, что эти файлы будут по-прежнему появляться в файловой системе после потери мощности или сбоя системы. Этот код ошибки указывает на проблему, связанную с попыткой выполнить этот финк().

SQLITE_IOERR_FSTAT — расширенный код ошибок для SQLITE_IOERR, указывающий на ошибку I/O в слое VFS, в то же время пытаясь использовать fstat() (или эквивалентный) в файле для определения такой информации, как размер файла или разрешения на доступ.

SQLITE_IOERR_FSYNC — расширенный код ошибок для SQLITE_IOERR, указывающий на ошибку I/O в слое VFS, пытаясь смыть ранее записанное содержание буферов управления ОС и/или диска в стойкое хранение. Другими словами, этот код указывает на проблему с вызовом системы fsync() в Unix или вызовом системы FlushFileBuffers() в окна.

SQLITE_IOERR_GETEMPPATS — расширенный код ошибки для SQLITE_IOERR, указывающий на то, что VFS не может определить подходящий каталог для размещения временных файлов.

SQLITE_IOERR_LOCK — расширенный код ошибок для SQLITE_IOERR, указывающий на ошибку I/O в логике ввода в файл. Обычно ошибка SQLITE_IOERR_LOCK указывает на проблему получения замка PENDING. Однако она может также указывать различные ошибки блокировки на некоторых специализированных VFS, используемых на Maxs.

SQLITE_IOERR_MMAP — расширенный код ошибки для SQLITE_IOERR, указывающий на ошибку I/O в xFetch или xUnfetch методов на объекте квадратного уровня 3_io_метод, в то же время пытаясь картировать или не писать часть файла базы данных в пространстве адреса процесса.

Код ошибки SQLITE_IOERR_NOMEM иногда возвращается с помощью слоя VFS, чтобы указать, что операция не может быть завершена из-за неспособности выделить достаточное количество памяти. Этот код ошибки обычно преобразуется в SQLITE_NOMEM более высокими слоями SQLite перед возвращением в приложение.

SQLITE_IOERR_RDLOCK — расширенный код ошибки для SQLITE_IOERR, указывающий на ошибку I/O в рамках метода xLock на объекте квадратного уровня 3_io_метод, в то же время пытающийся получить замок считывания.

SQLITE_IOERR_READ — расширенный код ошибки для SQLITE_IOERR, указывающий на ошибку I/O в слое VFS, когда мы пытаемся прочесть файл на диске. Эта ошибка может быть результатом сбоя в аппаратных средствах или потому, что файловая система была отключена во время открытия файла.

Код ошибки SQLITE_ioERR_ROLLBACK_ATOMIC указывает, что основная операционная система сообщила об ошибке в SQLITE_FCNTL_ROLLBACK_ATOMIC_WRITE. Это происходит только при включении SQLITE_ENLEL_ATOMIC_WRITE, а база данных размещена на файловой системе, поддерживающей атомные записи.

SQLITE_IOERR_SEEK — расширенный код ошибки для SQLITE_IOERR, указывающий на ошибку I/O в методах xRead или xWrite на объекте квадратного уровня 3_io_метод, в то же время пытающийся найти дескриптор файла в начальной точке файла, где должно произойти чтение или запись.

Код ошибки SQLITE_IOERR_SHMLOCK больше не используется.

SQLITE_IOERR_SHMMAP — расширенный код ошибок для SQLITE_IOERR, указывающий на ошибку I/O в методе xShmMap на объекте квадратного уровня 3_io_метод, в то же время пытающийся зафиксировать сегмент общей памяти в пространстве адреса процесса.

SQLITE_IOERR_SHMOPEN — расширенный код ошибки для SQLITE_IOERR, указывающий на ошибку I/O в рамках метода xShmMap на объекте квадратного уровня 3_io_метод, в то же время пытающийся открыть новый сегмент общей памяти.

SQLITE_IOERR_SHMSIZE — расширенный код ошибки для SQLITE_IOERR, указывающий на ошибку I/O в методе xShmMap на объекте квадратного уровня 3_io_методы, в то же время пытаясь расширить файл "shm" в рамках обработки режима WAL. Эта ошибка может указывать на то, что базовый объем файловой системы выведен из пространства.

SQLITE_IOERR_SHORT_READ — расширенный код ошибки для SQLITE_IOERR, указывающий на то, что попытка чтения в слое VFS не смогла получить столько байтов, сколько было запрошено. Это может быть связано с уплотненным файлом.

SQLITE_IOERR_TRUNCATE — расширенный код ошибки для SQLITE_IOERR, указывающий на ошибку I/O в слое VFS, пытаясь изменить размер файла с использованием метода xTruncate объекта квадратного уровня 3_io_метод.

SQLITE_IOERR_UNLOCK — расширенный код ошибок для SQLITE_IOERR, указывающий на ошибку I/O в рамках метода xUnlock на квадрате 3_io_метод.

Код ошибки SQLITE_IOERR_VNODE — код, предназначенный для использования при расширении.

SQLITE_IOERR_WRITE — расширенный код ошибки для SQLITE_IOERR, указывающий на ошибку I/O в слое VFS, пытаясь записать в файл на диске. Эта ошибка может быть результатом сбоя в аппаратных средствах или потому, что файловая система не была установлена во время открытия файла. Эта ошибка не должна происходить, если файловая система заполнена, поскольку для этой цели существует отдельный код ошибки (SQLITE_FULL).

Код результата SQLITE_LOCKED указывает, что операция записи не могла продолжаться из-за конфликта в рамках одного и того же подключения к базе данных или конфликта с другим подключением базы данных, в котором используется общий кэш. Например, заявление DROP Table не может быть запущено, в то время как другая нить читается из этой таблицы на том же подсоединении базы данных, потому что выбрасывание таблицы могло бы удалить таблицу из под одновременно считываемым читателем. Код результата SQLITE_LOCKED отличается от SQLITE_BUSY в том, что SQLITE_LOKED указывает на коллизию на одной и той же связи с базой данных (или на связи с общим кэшом), тогда как SQLITE_BUSY указывает на коллизию с другой связью базы данных, вероятно, в другом процессе.

SQLITE_LOCKED_SHAREDCACHE указывает, что доступ к записи данных SQLite блокируется другим подключением к базе данных, использующим ту же запись в режиме совместного кэша. Когда два или более подключений к базе данных имеют один и тот же кэш и один из них находится в середине изменения записи в этом кэше, тогда другие соединения блокируются от доступа к этим данным, в то время как модификация продолжается, чтобы не дать читателям увидеть коррумпированные или частично завершенные изменения.

SQLITE_LOCKED_VTAB код результата не используется SQLite, но он доступен для использования в расширениях. Виртуальная таблица может вернуть этот код результата, чтобы указать, что они не могут завершить текущую операцию из-за замков, удерживаемых другими нитями или процессами. Расширение R-Trie возвращает этот код результата, когда делается попытка обновить R-Trie, в то время как другое подготовленное заявление активно читает R-Trie. Обновление не может продолжаться, поскольку любое изменение R-Trie может быть связано с перезагрузкой и перебалансированием узлов, что может нарушить курсоры чтения, что приведет к повторению некоторых строк и опущению других строк.

Код ошибки SQLITE_MISMATch указывает на несоответствие типа данных. SQLite обычно очень прощает о несоответствиях между типом значения и заявленным типом контейнера, в котором это значение должно храниться. Например, SQLite позволяет приложение хранить большой BLOB в столбце с объявленным типом BOLEAN. Но в некоторых случаях SQLite строго относится к типам. Ошибка SQLITE_MISMATCH возвращается в тех нескольких случаях, когда типы не совпадают. Строка таблицы должна быть целой. Попытка установить строки во что-либо, кроме целого (или NULLL, которая будет автоматически преобразована в следующий доступный целый ряд) приводит к ошибке SQLITE_MISMATCH.

Код возврата SQLITE_MISUSE может быть возвращен, если приложение использует любой интерфейс SQLite в неопределенном или неподтверждённом виде. Например, использование подготовленного заявления после завершения этого заявления может привести к ошибке SQLITE_MISUSE. SQLite пытается обнаружить неправильное использование и сообщить о неправильном использовании с использованием этого кода результата. Однако нет гарантии того, что обнаружение неправильного использования будет успешным. Обнаружение неправильного использования является вероятной. Прикладные программы никогда не должны зависеть от значения возврата SQLITE_MISUSE. Если SQLite когда-либо возвращает SQLITE_MISUSE из любого интерфейса, это означает, что приложение неправильно кодировано и должно быть установлено. Не отправляйте приложение, которое иногда возвращает SQLITE_MISE из стандартного интерфейса SQLite, потому что не отправьте приложение, которое иногда SQLITE_MISE из стандартного интерфейса SQLitE Это приложение содержит потенциально серьёзные ошибки.