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

PostgreSQL 25001: невозможно выполнить внутри блока транзакции

Некоторые команды (VACUUM, CREATE DATABASE, CREATE INDEX CONCURRENTLY, ALTER SYSTEM) должны выполняться отдельно, вне блока BEGIN ... COMMIT.

SQLSTATE
25001
Имя
active_sql_transaction
Категория
Недопустимое состояние транзакции
Сообщение об ошибке
CREATE INDEX CONCURRENTLY cannot run inside a transaction block

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

Некоторые команды PostgreSQL сами управляют своими транзакциями или их нельзя откатить, поэтому они отказываются выполняться внутри явного блока транзакции: VACUUM, CREATE DATABASE, DROP DATABASE, CREATE INDEX CONCURRENTLY, REINDEX ... CONCURRENTLY, ALTER SYSTEM, CREATE TABLESPACE и другие. Попытка выполнить их подряд BEGIN завершится ошибкой 25001 (active_sql_transaction).

Загвоздка в том, что многие инструменты и драйверы открывают транзакцию за вас: фреймворки миграций оборачивают каждую миграцию в транзакцию, а клиенты с выключенным автокоммитом начинают её неявно.

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

  • Фреймворк миграций выполняет каждую миграцию внутри транзакции.
  • У клиента или драйвера выключен автокоммит (по умолчанию в psycopg2, в JDBC с setAutoCommit(false)), поэтому каждый оператор выполняется внутри транзакции.
  • Скрипт отправляет несколько операторов одной строкой многооператорного запроса, и PostgreSQL выполняет её как одну неявную транзакцию.
  • Вызов команды из функции или DO блока, который всегда выполняется внутри транзакции.

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

  1. Выполните команду отдельно с включенным автокоммитом. В psql это значение по умолчанию; просто не помещайте её между BEGIN и COMMIT.

    CREATE INDEX CONCURRENTLY orders_customer_id_idx ON orders (customer_id);
  2. В вашем драйвере включите автокоммит для этого оператора (psycopg: conn.autocommit = True).

  3. В инструментах миграций пометьте миграцию как нетранзакционную; в большинстве фреймворков для этого есть опция.

  4. Отправляйте каждую такую команду как отдельный запрос, а не объединяя их с другими в одну строку.

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

BEGIN;
VACUUM;  -- ERROR: VACUUM cannot run inside a transaction block
ROLLBACK;

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

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

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

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

Работа с PostgreSQL в SQLly

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