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

Ошибка SQLITE_NOLFS может быть возвращена в системах, которые не поддерживают большие файлы, когда база данных становится больше, чем то, с чем может справиться файловая система. "NOLFS" означает "NO Major File Support".

Код результата SQLITE_NOMEM указывает, что SQLite не смог распределить всю память, необходимую для завершения операции. Другими словами, внутренний вызов на квадрат 3_malloc() или квадратный 3_realloc() не сработал в том случае, когда для продолжения операции необходима память.

При попытке открыть файл ошибка SQLITE_NOTAB указывает на то, что открытый файл, как представляется, не является файлом SQLite.

Код результатов SQLITE_NOTFOD обнажается тремя способами: код результатов SQLITE_NOTFOFNUS также используется внутри SQLite, но эти внутренние виды использования не подвергаются воздействию приложения.

Код результата SQLITE_NOTICE не возвращается каким-либо интерфейсом C/C++. Однако SQLITE_NOTICE (или, скорее, один из расширенных кодов ошибок) иногда используется в качестве первого аргумента в квартете3_log() для подтверждения того, что происходит необычная операция.

Код результата SQLITE_NOTICE_RECOVER_ROLLBACK передается обратно на звонок в квартете3_log(), когда горячий журнал переворачивается обратно.

Код результата SQLITE_NOTICE_RECOVER_WAL передается обратно на звонок в файл () WAL.

Код результата SQLITE_PERM указывает, что запрошенный режим доступа для вновь созданной базы данных не может быть предоставлен.

SQLITE_PROTOCOL (код результата SQLITE_PROTOCOL) указывает на проблему с протоколом блокировки файлов, используемым SQLite. Ошибка SQLITE_PROTOCOL в настоящее время возвращается только при использовании WAL и попытке начать новую операцию. Существует условие расы, которое может возникнуть, когда два отдельных подключения к базе данных пытаются одновременно начать операцию в режиме WAL. Проигравший в гонке отключается и попробует снова после небольшой задержки. Если одна и та же связь теряет гонку блокировки десятки раз за несколько секунд, то в конечном счете она отдастся и возвратит SQLITE_PROTOCOL. Ошибка SQITE_PROTOCOL должна появиться на практике очень редко и только тогда, когда существует множество отдельных процессов, которые сильно конкурируют для записи в одну базу данных.

Индексы погрешности SQLITE_RANGE, что число параметров в одном из рутинных рутинок квадрата 3_ бинда или номер столбца в одном из шифров квадрата 3_колонны не в пределах диапазона.

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

SQLITE_READONLY_CANTINIT результатный код берет свое начало в методе xShmMap в VFS для указания, что регион общей памяти, используемый WAL, существует, но его содержание ненадежно и непригодно для использования в текущем процессе, поскольку текущий процесс не имеет разрешения на запись в регионе общей памяти. (Общая область памяти для WAL обычно является файлом с суффиксом "wal", который помянут в пространство процесса. Если текущий процесс не имеет разрешения на запись в этом файле, то он не может записать в общую память.) Более высокий уровень логики в SQLite обычно перехватит код ошибки и создаст временную область совместной памяти в мемориальном режиме, с тем чтобы текущий процесс мог по крайней мере прочитать содержание базы данных. Этот код результата не должен достигать слоя интерфейса приложения.

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

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

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

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

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

Код результата SQLITE_SCEMA указывает, что схема базы данных изменилась. Этот код результата может быть возвращен из квадрата 3_step() для подготовленного заявления, которое было составлено с использованием квадрата 3_prepare() или квадратного квадрата 3_prepare16(). Если схема базы данных была изменена каким-либо другим процессом в период между подготовкой заявления и началом записи, то может быть допущена ошибка. Если подготовленное заявление генерируется с помощью квадрата 3_prepare_v2(), то это заявление автоматически переподготовляется, если схема изменяется до SQLITE_MAX_SCEMA_RETRY времени (по умолчанию: 50). если после этого многие случаи отказа остаются в силе.

Код ошибки SQLITE_TOOBIG указывает, что строка или BLOB была слишком большой. Максимальная длина струн или BLOB в SQLite составляет 1000 000 000 байтов. Эта максимальная длина может быть изменена в момент компиляции с использованием SQLITE_MAX_LENGTH, опции времени компилирования, или в момент работы, с использованием krulite3_db,SQLITE_LILIT_LENTH, ......... 2 () интерфейсы. Максимальная длина SQL по умолчанию равна 1 000 000 байт. Максимальная длина SQL может быть установлена в момент компилирования с использованием SQLITE_MAX_SQL_LENGTH или в рабочем времени с использованием quorlite3_bimit(db,SQLIT_LIMIT_SQL_LENGTH, ...).

Код результата SQLITE_WARING не возвращается каким-либо интерфейсом C/C++. Однако SQLITE_WARNING (или скорее один из его расширенных кодов ошибок) иногда используется в качестве первого аргумента в квартете3_log() для указания того, что происходит необычная и, возможно, непредусмотренная операция.

Код результата SQLITE_WARING_AUTOINDEX передается обратно на звонок quorlite3_log() всякий раз, когда используется автоматическая индексация. Это может служить предупреждением разработчикам приложений о том, что база данных может выиграть от дополнительных индексов.