PostgreSQL 25001: невозможно выполнить внутри блока транзакции
Некоторые команды (VACUUM, CREATE DATABASE, CREATE INDEX CONCURRENTLY, ALTER SYSTEM) должны выполняться отдельно, вне блока BEGIN ... COMMIT.
- SQLSTATE
25001- Имя
active_sql_transaction- Категория
- Недопустимое состояние транзакции
Что это значит
Некоторые команды 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блока, который всегда выполняется внутри транзакции.
Как исправить
-
Выполните команду отдельно с включенным автокоммитом. В psql это значение по умолчанию; просто не помещайте её между
BEGINиCOMMIT.CREATE INDEX CONCURRENTLY orders_customer_id_idx ON orders (customer_id);
-
В вашем драйвере включите автокоммит для этого оператора (psycopg:
conn.autocommit = True). -
В инструментах миграций пометьте миграцию как нетранзакционную; в большинстве фреймворков для этого есть опция.
-
Отправляйте каждую такую команду как отдельный запрос, а не объединяя их с другими в одну строку.
Безопасное воспроизведение
BEGIN; VACUUM; -- ERROR: VACUUM cannot run inside a transaction block ROLLBACK;
Связанные ошибки
25P02текущая транзакция прервана2D000недопустимое завершение транзакции55006объект используется
Больше ошибок недопустимого состояния транзакции
Код и текст сообщения взяты из Документация PostgreSQL, приложение A: коды ошибок PostgreSQL. Смотрите весь Список ошибок PostgreSQL или поиск по всем ошибкам баз данных.
Работа с PostgreSQL в SQLly
Нативный SQL-клиент для macOS, Windows и Linux с IntelliSense, который знает вашу схему, предохранителями для рискованных запросов и понятными сообщениями об ошибках — для PostgreSQL и других баз данных, которые вы используете.