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

PostgreSQL 25006: SQL-транзакция только для чтения

Была предпринята запись в транзакцию только для чтения: на реплике в режиме hot-standby, с включённой опцией default_transaction_read_only, или после SET TRANSACTION READ ONLY.

SQLSTATE
25006
Имя
read_only_sql_transaction
Категория
Недопустимое состояние транзакции
Сообщение об ошибке
cannot execute INSERT in a read-only transaction

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

PostgreSQL отказывается INSERT, UPDATE, DELETE, DDL и другие операции записи, когда транзакция доступна только для чтения. Так происходит, когда вы подключены к standby потоковой репликации (там все транзакции доступны только для чтения), когда default_transaction_read_only включено для сервера, базы данных или роли, или когда была начата транзакция READ ONLY.

Сообщение называет команду, которая была отклонена.

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

  • Соединение попало на реплику только для чтения — например, через балансировщик нагрузки или DNS-имя, которое после failover указывает на резервный сервер.
  • default_transaction_read_only = on задано на уровне базы данных или роли, иногда намеренно — для пользователей отчётов.
  • BEGIN READ ONLY или SET TRANSACTION READ ONLY ранее в транзакции.
  • Управляемая база данных перешла в режим только для чтения, потому что у неё закончилось место на диске.

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

  1. Проверьте, находитесь ли вы на резервном сервере и включён ли режим «только для чтения».

    SELECT pg_is_in_recovery();
    SHOW default_transaction_read_only;
    SHOW transaction_read_only;
  2. Отправляйте записи на основной сервер. С libpq 14 и выше, target_session_attrs=read-write в строке подключения выбирает доступный для записи хост из списка.

  3. Если роль или база данных по ошибке переведены в режим только для чтения, отключите его.

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

Безопасное воспроизведение

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

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

Больше ошибок недопустимого состояния транзакции

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

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

Работа с PostgreSQL в SQLly

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