// Referencia de errores de PostgreSQL

PostgreSQL 25006: transacción SQL de solo lectura

Se intentó escribir en una transacción de solo lectura: en una réplica en espera activa, con default_transaction_read_only activado o tras SET TRANSACTION READ ONLY.

SQLSTATE
25006
Nombre
read_only_sql_transaction
Categoría
Estado de transacción no válido
Mensaje de error
cannot execute INSERT in a read-only transaction

Qué significa

PostgreSQL rechaza INSERT, UPDATE, DELETE, DDL y otras escrituras cuando la transacción es de solo lectura. Eso ocurre cuando estás conectado a una réplica en espera con replicación en streaming (todas las transacciones allí son de solo lectura), cuando default_transaction_read_only está activado para el servidor, la base de datos o el rol, o cuando se inició la transacción READ ONLY.

El mensaje indica el comando que se rechazó.

Causas comunes

  • La conexión fue a una réplica de lectura, por ejemplo a través de un balanceador de carga o un nombre DNS que apunta a un servidor en espera (standby) después de una conmutación por error.
  • default_transaction_read_only = on activado en la base de datos o rol, a veces deliberadamente para usuarios de informes.
  • BEGIN READ ONLY o SET TRANSACTION READ ONLY anteriormente en la transacción.
  • Una base de datos gestionada cambió a solo lectura porque se quedó sin espacio de almacenamiento.

Cómo solucionarlo

  1. Comprueba si estás en un standby y si está configurado como de solo lectura.

    SELECT pg_is_in_recovery();
    SHOW default_transaction_read_only;
    SHOW transaction_read_only;
  2. Envía escrituras al primario. Con libpq 14 y posteriores, target_session_attrs=read-write en la cadena de conexión elige el host escribible de una lista.

  3. Si el rol o la base de datos se quedó en solo lectura por error, quítalo.

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

Reprodúcelo de forma segura

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

Errores relacionados

Más errores de estado de transacción no válido

El código y el texto del mensaje son de documentación de PostgreSQL, Apéndice A: Códigos de error de PostgreSQL. Explora la lista completa de Lista de errores de PostgreSQL o buscar cada error de base de datos.

// menos errores, correcciones más rápidas

Trabajar con PostgreSQL en SQLly

Un cliente SQL nativo para macOS, Windows y Linux con IntelliSense que conoce el esquema, protecciones para las instrucciones de riesgo y mensajes de error claros, para PostgreSQL y las demás bases de datos que uses.