// справочник ошибок SQLite

SQLITE_IOERR: ошибка ввода-вывода на диске

Операционная система сообщила об ошибке ввода-вывода во время чтения, записи, синхронизации или блокировки файла в SQLite. Расширенный код указывает, какая операция не удалась.

Код результата
SQLITE_IOERR
Имя
10
Категория
Основные коды результатов
Сообщение об ошибке
disk I/O error

Что это значит

SQLITE_IOERR (10) означает, что операция с файлом не удалась на уровне операционной системы. SQLite имеет множество расширенных кодов для этого, таких как SQLITE_IOERR_READ, SQLITE_IOERR_WRITE, SQLITE_IOERR_FSYNC, SQLITE_IOERR_SHORT_READ (меньше байт, чем было запрошено, например, усечённый файл) и SQLITE_IOERR_LOCK. Полный диск обычно возвращает SQLITE_FULL вместо этого.

Лучше всего подскажет расширенный код, так что включите расширенные коды результатов или читайте их с помощью sqlite3_extended_errcode().

Распространённые причины

  • Неисправное или отключённое хранилище: извлечённый USB-накопитель, отключённая сетевая папка, сбойный диск.
  • Сетевая файловая система или синхронизируемая папка, которая не поддерживает блокировку или синхронизацию, необходимые SQLite.
  • Антивирус или ПО для резервного копирования удерживает или изменяет файл.
  • Файл был усечён или заменён под открытым соединением.

Как исправить

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

  2. Храните базу данных на локальном диске. Если её необходимо совместно использовать, не делитесь файлом: поставьте перед ним сервер.

  3. Исключите базу данных, -journal, -wal и -shm файлы из сканирования антивирусом и инструментов синхронизации файлов.

  4. После любой ошибки ввода-вывода проверьте файл перед тем, как доверять ему.

    PRAGMA integrity_check;

Связанные ошибки

Больше ошибок основных кодов результатов

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

// меньше ошибок, быстрее исправления

Работа с SQLite в SQLly

Нативный SQL-клиент для macOS, Windows и Linux с IntelliSense, который знает вашу схему, предохранителями для рискованных запросов и понятными сообщениями об ошибках — для SQLite и других баз данных, которые вы используете.