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

PostgreSQL 2D000: неверное завершение транзакции

COMMIT или ROLLBACK выполнены внутри процедуры или блока DO, который не может управлять транзакциями, например вызванного внутри явной транзакции или из функции.

SQLSTATE
2D000
Имя
invalid_transaction_termination
Категория
Недопустимое завершение транзакции
Сообщение об ошибке
invalid transaction termination

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

Начиная с PostgreSQL 11 процедуры (CALL) и DO блоки могут выполняться COMMIT и ROLLBACK. Это работает, только когда они вызываются на верхнем уровне, а не внутри транзакции, открытой вызывающей стороной. Если процедура вызывается после BEGIN, из функции, из триггера или через путь, который оборачивает её в транзакцию, её COMMIT завершится ошибкой 2D000.

Функции никогда не могут выполнять commit или rollback; их работа всегда является частью транзакции вызывающего.

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

  • Вызов процедуры внутри BEGIN ... COMMIT, или с клиента с отключённым автокоммитом.
  • Вызов её из функции, триггера или SELECT.
  • A COMMIT внутри тела функции, а не процедуры.
  • A COMMIT внутри блока, который имеет EXCEPTION , который выполняется как подтранзакция.

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

  1. Вызовите процедуру отдельно, с включённым автокоммитом.

    CALL archive_old_orders();
  2. Если вам нужен контроль транзакций, сделайте это процедурой, а не функцией, и держите COMMIT вне блоков с обработчиками исключений.

    CREATE PROCEDURE archive_old_orders()
    LANGUAGE plpgsql AS $$
    BEGIN
        LOOP
            DELETE FROM orders WHERE id IN (
                SELECT id FROM orders WHERE created_at < now() - interval '2 years' LIMIT 1000);
            EXIT WHEN NOT FOUND;
            COMMIT;
        END LOOP;
    END;
    $$;

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

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

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

Работа с PostgreSQL в SQLly

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