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

SQLITE_READONLY: попытка записи в базу данных только для чтения

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

Код результата
SQLITE_READONLY
Имя
8
Категория
Основные коды результатов
Сообщение об ошибке
attempt to write a readonly database

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

SQLITE_READONLY (8) возвращается, когда инструкция пытается изменить данные, к которым соединение не имеет прав на запись. Для записи необходимы права на файл базы данных и на его каталог, так как SQLite создает рядом файл журнала (-journal) или WAL (-wal, -shm) файл.

Расширенные коды объясняют причину: SQLITE_READONLY_DIRECTORY (нет прав на создание журнала), SQLITE_READONLY_DBMOVED (файл был перемещён или удалён, пока был открыт), SQLITE_READONLY_ROLLBACK (горячий журнал нужно откатить, а база данных открыта только для чтения) и другие.

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

  • Файл базы данных принадлежит другому пользователю или смонтирован только для чтения, что типично для пользователя веб-сервера или файла внутри пакета приложения.
  • Каталог недоступен для записи, поэтому SQLite не может создать файл журнала, даже если сам файл доступен.
  • Соединение было открыто только для чтения (SQLITE_OPEN_READONLY, ?mode=ro URI, или PRAGMA query_only = ON).
  • Файл был перемещен, переименован или удален, пока соединение было открыто (SQLITE_READONLY_DBMOVED).

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

  1. Дайте процессу разрешение на запись для файла и для его каталога. В Linux и macOS проверьте с помощью ls -l для обоих, затем исправьте владение или режим.

  2. Проверьте, является ли само соединение только для чтения.

    PRAGMA query_only;
    PRAGMA database_list;
  3. Откройте базу данных для чтения и записи: уберите mode=ro из URI или флага только для чтения при вызове открытия.

  4. Если файл переместили, пока он был открыт, закройте подключение и откройте его заново по новому пути.

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

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

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

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

Работа с SQLite в SQLly

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