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

Код результата SQLITE_ABORT указывает, что операция была прервана до завершения, как правило, по запросу. См. также: SQLITE_INTERRUPT. Если функция обратного вызова в квадрат 3_exec() возвращает ненулевой, то квадрат 3_exec() возвращает SQLITE_ABORT. Если операция ROLLBACK происходит на том же подключении к базе данных, что и ожидаемое чтение или запись, то неучтенное чтение или запись может не сработать с ошибкой SQLITE_ABORT_ABORT_ROLLBACK. Кроме того, как код результата, значение SQLITE_ABORT используется также в качестве режима разрешения конфликта, возвращаемого с интерфейса SQLITE3_vtab_on_on_conlict().

SQLITE_ABORT_ROLLBACK — расширенный код ошибки для SQLITE_ABORT, указывающий, что запись SQL была прервана, потому что операция, которая была активирована в момент начала SQL, была свернута назад. До того, как операции по записи всегда провалятся с этой ошибкой, когда происходит возврат. ROLLBACK приведет к тому, что незавершенная операция считывания не сработает только в том случае, если схема была изменена в рамках операции, которая была свернута обратно.

Ошибка SQLITE_AUTH возвращается, когда ответный звонок уполномоченного указывает на то, что заявление SQL, которое готовится, не разрешено.

SQLITE_AUTH_USER — расширенный код ошибок для SQLITE_AUTH, указывающий на то, что операция была предпринята в базе данных, для которой у пользователя нет достаточного разрешения.

Код результата SQLITE_BUSY указывает, что файл базы данных не может быть написан (или в некоторых случаях читается) из-за параллельной деятельности, связанной с каким-либо другим подключением базы данных, обычно подсоединением к базе данных в рамках отдельного процесса. Например, если процесс A находится в середине крупной операции в письменной форме и в то же время процесс B пытается начать новую операцию в письменной форме, процесс B получит результат SQLITE_BUSY, потому что SQLite поддерживает только одного автора за один раз. Процесс B должен будет подождать, пока процесс A закончит свою операцию до начала новой операции. Urlite3_busy_taimout() и firlite3_busy_handler() интерфейсы и занятое_taimeout pragma доступны для обработки B, чтобы помочь ему справиться с ошибками SQLITE_BUSY. Ошибка SQLITE_BUSY может быть допущена в любой момент сделки: когда операция начинается впервые, во время любой операции по письму или обновлению, или когда операция совершается. Для того чтобы избежать ошибок SQLITE_BUSY в середине операции, приложение может использовать BEGIN IMMEDATE вместо BEGIN для начала операции. Команда BEGIN IMMEDITAT может сама вернуть SQLITE_BUSY, но в случае ее успеха SQLITE_BUSY гарантирует, что никакие последующие операции в одной и той же базе данных через следующий Objection не вернут SQLITE_BUSY. См. также: SQLITE_BUSY_RECOVERY и SQLITE_BUSSHOT. SQLITE_LOCKED в том, что SQLITE_BUSY указывает на конфликт с отдельным подключением к базе данных, вероятно, в отдельном процессе, в то время как SQLITE_LOCKED указывает на конфликт в рамках одного и того же подключения к базе данных (или иногда на связь с общей кэшой).

SQLITE_BUSY_RECOVERY — расширенный код ошибки для SQLITE_BUSY, который указывает, что операция не может продолжаться, поскольку другой процесс занят восстановлением файла WAL в режиме WAL после аварии. SQLITE_BUSY_RECOVERY код ошибки происходит только в базах данных WAL.

Код ошибки SQLITE_BUSY_SNAPSHOT — расширенный код ошибки для SQLITE_BUSY, который происходит в базах данных WAL, когда подсоединение базы данных пытается содействовать считыванию операции в письменной форме, но устанавливает, что другое подсоединение базы данных уже записано в базу данных и тем самым аннулировано ранее. Следующий сценарий показывает, как ошибка SQLITE_BUSY_SNAPSHOT может возникнуть:

Код ошибки SQLITE_BUSY_TIMEUT указывает, что запрос блокировки Po6 в слое VFS не сработал из-за временного отказа. Блокирование Po6 консультативных шлюзов доступно только в качестве запатентованного SQLite, и даже в этом случае поддерживается только в том случае, если SQLite компилируется с опцией SQLITE_ENELELK_TIMEOUT.

Код результата SQLITE_CANTOPEN указывает, что SQLite не смог открыть файл. Этот файл может быть первичным файлом базы данных или одним из нескольких временных файлов диска.

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

Код результата SQLITE_CANTOPEN_DIRTYWAL в данный момент не используется.

SQLITE_CANTOPEN_FULLPATH — расширенный код ошибки для SQLITE_CANTOPEN, указывающий на то, что файл не был открыт потому, что операционная система не смогла преобразовать имя файла в полное имя.

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

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

Код результата SQLITE_CANTOPEN_SYMLINK возвращается интерфейсом квадратной 3_open() и его братьями и сестрами, когда используется флаг SQLITE_OPEN_NOFOLLOW и файл базы данных является символической ссылкой.

Код ошибки SQLITE_CONSTRAINT означает, что при попытке обработать заявление SQL имело место нарушение ограничения SQL. Дополнительная информация об отрицательном ограничении может быть найдена путем ознакомления с сопроводительным сообщением об ошибке (возврата через korlite3_errmsg() или kirlite3_errmsg16())) или путем просмотра расширенного кода ошибки. Код SQLITE_CONSTRAINT также может быть использован в качестве обратного значения из метода ввода в виртуальную таблицу xBestIndex. Когда xBestIndex() возвращает SQLITE_CONSTRAINT, который указывает, что конкретное сочетание вводимых данных, представленных в xBestIndex() не может привести к использованию плана запроса и не должно быть подвергнуто дальнейшему рассмотрению.

SQLITE_CONSTRAINT_CHECK — расширенный код ошибки для SQLITE_CONSTRAINT, указывающий на то, что ограничение CHECK не сработало.

SQLITE_CONSTRAINT_COMMITHOK — расширенный код ошибки для SQLITE_CONSTRAINT, указывающий на то, что крючок обратно возвращался не ноль, что, таким образом, послужило причиной обратного изменения записи SQL.

SQLITE_CONSTRAINT_DatatatyPE — расширенный код ошибки для SQLITE_CONSTRAINT, указывающий, что вставка или обновление пытались сохранить значение, не совместимое с заявленным типом колонки, в таблице, определяемой как CTRICT.

SQLITE_CONSTRAINT_FOREIGNKY — расширенный код ошибок для SQLITE_CONSTANT, указывающий на то, что чужеродное ограничение ключа не сработало.

Код ошибки SQLITE_CONSTRAINT_Function в настоящее время не используется ядром SQLite. Однако этот код ошибки доступен для использования в рамках функций расширения.

SQLITE_CONSTRAINT_NOTNULLL — расширенный код ошибки для SQLITE_CONSTRAINT, указывающий на то, что ограничение NOLL не сработало.

SQLITE_CONSTRAINT_PINNED — расширенный код ошибки для SQLITE_CONSTRAINT, указывающий на то, что спусковой механизм UPDATE пытался удалить строку, которая обновлялась в середине обновления.

SQLITE_CONSTRAINT_PRIMARYKEY — расширенный код ошибки SQLITE_CONSTRAINT, указывающий на то, что PRIMARY KKI contrONAINT не сработала.

SQLITE_CONSTRAINT_ROWID — расширенный код ошибки для SQLITE_CONSTRAINT, указывающий на то, что рамид не является уникальным.

SQLITE_CONSTRAINT_TRIGGER — расширенный код ошибки для SQLITE_CONSTRAINT, указывающий на то, что функция RAISE в системе запуска, что приводит к отключению заявления SQL.

Код ошибки SQLITE_CONSTRAINT_UNIQUE — расширенный код ошибки для SQLITE_CONSTRAINT, указывающий на то, что ограничение UNIQUE не сработало.

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

Код результата SQLITE_CORRUPT указывает на то, что файл базы данных был искажен. Смотрите файлы базы данных What To Corruption.

Код результата SQLITE_CORRUPT_INDEX означает, что SQLite обнаружила запись в индексе или отсутствовала. Это особый случай кода ошибки SQLITE_CORRUPT, который предполагает, что проблема может быть решена путем запуска команды RINDEX, при условии, что других проблем в файле базы данных не существует.

SQLITE_CORRUPT_SEQUONSION concern code означает, что схема таблицы квадратного_последовательности является коррумпированной. Таблица квадратного_последовательности используется для оказания помощи в реализации функции AUTOINCREUINSment. Таблица квадратного_последствия должна иметь следующий формат: если SQLite обнаруживает, что таблица квадратного_последовательности имеет любой другой формат, она возвращает ошибку SQLITE_CORRUPT_SEQUNERence.

SQLITE_CORRUPT_VTAB — расширенный код ошибки для SQLITE_CORRUPT, используемый в виртуальных таблицах. Виртуальная таблица может вернуть SQLITE_CORRUPT_VTAB, чтобы показать, что содержание в виртуальной таблице является коррумпированным.

В настоящее время не используется код результата SQLITE.

Код результата SQLITE_ERROR — это общий код ошибки, который используется в тех случаях, когда не имеется более конкретного кода ошибки.

SQLITE_ERROR_MISING_COLLSEQ (код результата SQL) означает, что SQL-код не может быть подготовлен, поскольку последовательность комбинирования, названная в SQL-описи. Иногда, когда этот код ошибки обнаружен, рутина квадрата 3_prepare_v2() преобразует ошибку в SQLITE_ERROR_RETRY и попытается снова подготовить заявление SQL с использованием другого плана запроса, который не требует использования неустановленной последовательности комбинаций.

SQLITE_ERROR_RETRY используется внутри для провоцирования квадратной строки 3_prepare_v2() (или одной из своих сестринских рутинок для создания подготовленных заявлений) чтобы снова попытаться подготовить заявление, которое не сработало с ошибкой предыдущей попытки.

Код результата SQLITE_ERROR_SNAPSHOT может быть возвращен, когда будет предпринята попытка начать операцию считывания на исторической версии базы данных с помощью интерфейса quorlite3_snaphot_open (). Если исторический снимок больше не доступен, то операция считывания не будет завершена с SQLITE_ERROR_SNAPSHOT. Этот код ошибки возможен только в том случае, если SQLite будет скомпилирован с помощью -DQLITE_ENLED_SNAPSHOT.

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

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

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