Управление транзакциями

примечание

Эта страница переведена при помощи нейросети GigaChat.

В процедурах, вызываемых командой CALL, а также в анонимных блоках кода (в команде DO), можно завершать транзакции с помощью команд COMMIT и ROLLBACK. Новая транзакция начинается автоматически после завершения транзакции с использованием этих команд, поэтому нет отдельной команды START TRANSACTION. Обратите внимание, что BEGIN и END имеют разные значения в PL/pgSQL.

Пример:

CREATE PROCEDURE transaction_test1()
LANGUAGE plpgsql
AS $$
BEGIN
    FOR i IN 0..9 LOOP
        INSERT INTO test1 (a) VALUES (i);
        IF i % 2 = 0 THEN
            COMMIT;
        ELSE
            ROLLBACK;
        END IF;
    END LOOP;
END;
$$;

CALL transaction_test1();

Новая транзакция начинается с характеристиками транзакции по умолчанию, такими как уровень изоляции транзакций. В случаях, когда транзакции фиксируются в цикле, может быть желательно автоматически начинать новые транзакции с теми же характеристиками, что и предыдущая. Команды COMMIT AND CHAIN и ROLLBACK AND CHAIN выполняют эту задачу.

Управление транзакциями возможно только при вызове CALL или DO на верхнем уровне или вложенных вызовах CALL или DO без каких-либо других промежуточных команд. Например, если стек вызовов выглядит так: CALL proc1() → CALL proc2() → CALL proc3(), то вторая и третья процедуры могут выполнять действия управления транзакцией. Но если стек вызовов выглядит так: CALL proc1() → SELECT func2() → CALL proc3(), то последняя процедура не может выполнить управление транзакцией из-за наличия SELECT между ними.

Особые соображения применимы к циклам курсоров. Рассмотрим этот пример:

CREATE PROCEDURE transaction_test2()
LANGUAGE plpgsql
AS $$
DECLARE
    r RECORD;
BEGIN
    FOR r IN SELECT * FROM test2 ORDER BY x LOOP
        INSERT INTO test1 (a) VALUES (r.x);
        COMMIT;
    END LOOP;
END;
$$;

CALL transaction_test2();

Обычно курсоры автоматически закрываются при фиксации транзакции. Однако курсор, созданный как часть такого цикла, автоматически преобразуется в удерживаемый курсор первым COMMIT или ROLLBACK. Это означает, что курсор полностью оценивается при первом COMMIT или ROLLBACK, а не построчно. Курсор все еще удаляется автоматически после цикла, поэтому это в основном незаметно для пользователя.

Команды управления транзакциями не допускаются в циклах с курсором, которыми управляют запросы, производящие не только чтение, но и модификацию данных (например, UPDATE ... RETURNING).

Транзакция не может быть завершена внутри блока с обработчиками исключений.