// Referência de erro do SQLite

SQLITE_READONLY: tentativa de gravar em um banco de dados somente leitura

A conexão não pode gravar: o arquivo ou seu diretório não é gravável, o banco de dados foi aberto como somente leitura, ou o SQLite não consegue criar seu arquivo de diário.

Código de resultado
SQLITE_READONLY
Nome
8
Categoria
Códigos de resultado primários
Mensagem de erro
attempt to write a readonly database

O que significa

SQLITE_READONLY O código (8) é retornado quando uma instrução tenta alterar dados para os quais a conexão não tem permissão de gravação. Gravar requer permissão no arquivo do banco de dados e também em seu diretório, porque o SQLite cria um arquivo de diário (-journal) ou WAL (-wal, -shm) ao lado dele.

Códigos estendidos indicam o motivo: SQLITE_READONLY_DIRECTORY (sem permissão para criar o diário) SQLITE_READONLY_DBMOVED (o arquivo foi movido ou excluído enquanto estava aberto), SQLITE_READONLY_ROLLBACK (um diário ativo precisa ser revertido, mas o banco de dados é somente leitura), e outros.

Causas comuns

  • O arquivo do banco de dados é propriedade de outro usuário ou está montado como somente leitura, típico para um usuário de servidor web ou um arquivo dentro de um pacote de aplicativo.
  • O diretório não é gravável, então o SQLite não consegue criar o arquivo de diário, mesmo que o arquivo em si seja gravável.
  • A conexão foi aberta como somente leitura (SQLITE_OPEN_READONLY, ?mode=ro URI, ou PRAGMA query_only = ON).
  • O arquivo foi movido, renomeado ou excluído enquanto a conexão estava aberta (SQLITE_READONLY_DBMOVED).

Como corrigir

  1. Dê ao processo permissão de escrita no arquivo e no diretório. No Linux e no macOS, verifique com ls -l em ambos, depois corrija a propriedade ou o modo.

  2. Verifique se a própria conexão é somente leitura.

    PRAGMA query_only;
    PRAGMA database_list;
  3. Abra o banco de dados para leitura e escrita: drop mode=ro do URI ou a flag de somente leitura da chamada de abertura.

  4. Se o arquivo foi movido enquanto estava aberto, feche a conexão e abra-o de novo no novo caminho.

Erros relacionados

Mais erros de códigos de resultado primário

O código e o texto da mensagem são de Documentação de códigos de resultado e erro do SQLite. Veja toda a Lista de erros do SQLite ou pesquise todos os erros do banco de dados.

// menos erros, correções mais rápidas

Trabalhe com SQLite no SQLly

Um cliente SQL nativo para macOS, Windows e Linux com IntelliSense que conhece o esquema, proteções para instruções arriscadas e mensagens de erro claras, para o SQLite e os outros bancos de dados que você usa.