// Référence des erreurs PostgreSQL

PostgreSQL 25006 : transaction SQL en lecture seule

Une écriture a été tentée dans une transaction en lecture seule : sur une réplique en veille chaude, avec default_transaction_read_only activé, ou après SET TRANSACTION READ ONLY.

SQLSTATE
25006
Nom
read_only_sql_transaction
Catégorie
État de transaction invalide
Message d'erreur
cannot execute INSERT in a read-only transaction

Ce que cela signifie

PostgreSQL refuse INSERT, UPDATE, DELETE, DDL et autres écritures lorsque la transaction est en lecture seule. Cela se produit lorsque vous êtes connecté à une réplique en veille de réplication en continu (toutes les transactions y sont en lecture seule), lorsque default_transaction_read_only est activé pour le serveur, la base de données ou le rôle, ou lorsque la transaction a été démarrée READ ONLY.

Le message indique le nom de la commande qui a été refusée.

Causes courantes

  • La connexion a abouti sur une réplique en lecture, par exemple via un répartiteur de charge ou un nom DNS pointant vers un serveur de secours après un basculement.
  • default_transaction_read_only = on activé sur la base de données ou le rôle, parfois délibérément pour les utilisateurs de reporting.
  • BEGIN READ ONLY ou SET TRANSACTION READ ONLY plus tôt dans la transaction.
  • Une base de données gérée est passée en lecture seule parce qu'elle avait épuisé son espace de stockage.

Comment le corriger

  1. Vérifiez si vous êtes sur un standby et si la lecture seule est activée.

    SELECT pg_is_in_recovery();
    SHOW default_transaction_read_only;
    SHOW transaction_read_only;
  2. Envoyez les écritures vers le primaire. Avec libpq 14 et versions ultérieures, target_session_attrs=read-write dans la chaîne de connexion choisit l'hôte accessible en écriture à partir d'une liste.

  3. Si la lecture seule a été activée par erreur sur le rôle ou la base de données, désactivez-la.

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

Reproduisez-le en toute sécurité

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

Erreurs liées

Plus d'erreurs d'état de transaction non valide

Le code et le texte du message sont issus de Documentation PostgreSQL, annexe A : Codes d’erreur PostgreSQL. Parcourir la liste complète Liste des erreurs PostgreSQL ou Rechercher toutes les erreurs de base de données.

// moins d'erreurs, corrections plus rapides

Travailler sur PostgreSQL dans SQLly

Un client SQL natif pour macOS, Windows et Linux avec IntelliSense conscient du schéma, des garde-fous pour les instructions risquées et des messages d'erreur clairs, pour PostgreSQL et les autres bases de données que vous utilisez.