// Referência de erro do PostgreSQL

PostgreSQL 25006: transação SQL somente leitura

Foi feita uma tentativa de escrita em uma transação somente leitura: em uma réplica hot-standby, com default_transaction_read_only ativado, ou após SET TRANSACTION READ ONLY.

SQLSTATE
25006
Nome
read_only_sql_transaction
Categoria
Estado de transação inválido
Mensagem de erro
cannot execute INSERT in a read-only transaction

O que significa

PostgreSQL recusa INSERT, UPDATE, DELETE, DDL e outras escritas quando a transação está somente leitura. Isso acontece quando você está conectado a um standby de replicação em streaming (todas as transações lá são somente leitura), quando default_transaction_read_only está ativado para o servidor, banco de dados ou função, ou quando a transação foi iniciada READ ONLY.

A mensagem indica o comando que foi recusado.

Causas comuns

  • A conexão foi para uma réplica de leitura, por exemplo por meio de um balanceador de carga ou de um nome DNS que aponta para um standby após um failover.
  • default_transaction_read_only = on ativado no banco de dados ou função, às vezes deliberadamente para usuários de relatório.
  • BEGIN READ ONLY ou SET TRANSACTION READ ONLY anterior na transação.
  • Um banco de dados gerenciado mudou para somente leitura porque esgotou o armazenamento.

Como corrigir

  1. Verifique se você está em um standby e se o modo somente leitura está ativado.

    SELECT pg_is_in_recovery();
    SHOW default_transaction_read_only;
    SHOW transaction_read_only;
  2. Envie gravações para o primário. Com libpq 14 e posteriores, target_session_attrs=read-write na string de conexão escolhe o host gravável de uma lista.

  3. Se o modo somente leitura foi configurado no papel ou no banco de dados por engano, desative-o.

    ALTER ROLE app SET default_transaction_read_only = off;
    ALTER DATABASE shop SET default_transaction_read_only = off;

Reproduza com segurança

BEGIN READ ONLY;
CREATE TEMP TABLE t (id int);  -- ERROR: cannot execute CREATE TABLE in a read-only transaction
ROLLBACK;

Erros relacionados

Mais erros de estado de transação inválido

O código e o texto da mensagem são de documentação do PostgreSQL, Apêndice A: Códigos de erro do PostgreSQL. Veja toda a Lista de erros do PostgreSQL ou pesquise todos os erros do banco de dados.

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

Trabalhe com PostgreSQL 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 PostgreSQL e os outros bancos de dados que você usa.