| Предыдущий | Следующий |
| SQLITE_E_NOTFOUND | SQLITE_E_CANTOPEN |
SQLITE_E_FULL
Что означает SQLITE_E_FULL
SQLITE_E_FULL — HRESULT, относящийся к области SQLite. SQLite не может продолжить запись: база данных, файловая система или выделенная квота достигла предела ёмкости.
В случае SQLITE_E_FULL источник результата — библиотека SQLite, поэтому проверять нужно не только текст SQL, но и жизненный цикл prepared statement, транзакции, соединения и файлов базы.
Практический вывод для SQLITE_E_FULL: этот HRESULT фиксирует описанное условие, но сам по себе не показывает, какой участник операции первым нарушил контракт. Для SQLITE_E_FULL найдите первый вызов, вернувший статус, и только после этого меняйте конфигурацию подсистемы SQLite.
Как читать имя SQLITE_E_FULL
Имя SQLITE_E_FULL помогает сузить поиск: FULL — исчерпанная ёмкость. Эти части имени не заменяют документацию API, но позволяют проверить, что журнал и код относятся к одному и тому же условию.
Проверка причины
В случае SQLITE_E_FULL важно сохранить исходный контекст вызова: имя функции, параметры, состояние объекта и первый низкоуровневый статус. В случае SQLITE_E_FULL без этого одинаковый HRESULT может ошибочно связываться с разными причинами.
- При разборе SQLITE_E_FULL проверьте время жизни prepared statement, транзакций и соединений, особенно при параллельной работе.
- При разборе SQLITE_E_FULL работайте с копией базы при проверке целостности; не исправляйте живой файл обрезанием или ручным редактированием.
- При разборе SQLITE_E_FULL запишите SQL, типы и индексы привязанных параметров, расширенный код SQLite и текст sqlite3_errmsg().
- При разборе SQLITE_E_FULL сохраните фактический путь базы, режим открытия, journal_mode, версию SQLite и используемый VFS.
Какие данные собрать
- Для SQLITE_E_FULL создайте минимальный тест с тем же SQL, схемой и режимом соединения.
- Для SQLITE_E_FULL включите расширенные коды результатов и зафиксируйте первый вызов SQLite, вернувший ошибку.
- Для SQLITE_E_FULL сопоставьте проблему с разрешениями каталога, sidecar-файлами -wal/-shm/-journal и семантикой блокировок хранилища.
Команда или запрос для проверки SQLITE_E_FULL
Для SQLITE_E_FULL ниже сохранён технический пример из исходной страницы. Он не исправляет SQLITE_E_FULL сам по себе, но помогает проверить соответствующий параметр или состояние в контролируемой среде.
PRAGMA page_count;
PRAGMA max_page_count;Критерий успешного исправления
В случае SQLITE_E_FULL считайте причину SQLITE_E_FULL устранённой только после проверки на тех же данных и под той же учётной записью, где возник сбой, а затем выполните контрольный тест с заведомо неверным входом.
Ссылки по SQLITE_E_FULL
Нужно найти другой код? Найти другой код состояния или ошибки.