PolarDB:DBMS_TRANSACTION

特徴

PolarDB for PostgreSQL (Oracle 互換) は、次の 4 つの関数をサポートしています:

• SAVEPOINT: トランザクションにセーブポイントをマークします。後でこのセーブポイントにロールバックできます。

• ROLLBACK_SAVEPOINT: トランザクションを指定されたセーブポイントにロールバックします。これにより、セーブポイントが設定された後に行われた操作が取り消されます。

• COMMIT: 現在のトランザクションをコミットします。これにより、すべてのデータ変更が永続化されます。

• ROLLBACK: トランザクション全体をロールバックします。これにより、コミットされていないすべての操作が取り消されます。

前提条件

この機能は、マイナーエンジンバージョンが 2.0.14.17.34.0 以降の Oracle 構文互換 2.0 でのみサポートされています。

注意

• SAVEPOINT と ROLLBACK_SAVEPOINT を使用する前に、polar_default_pl_stmt_transaction_rollback パラメーターを有効にしてください。

• COMMIT または ROLLBACK は現在のトランザクションを終了します。続行するには、新しいトランザクションを開始する必要があります。

• SAVEPOINT を頻繁に使用すると、トランザクションのオーバーヘッドが増加する可能性があります。トランザクションの粒度を慎重に計画してください。

• BEGIN_WORK や SET_TRANSACTION などの高度な機能はサポートされていません。

• EXECUTE IMMEDIATE シナリオで COMMIT または ROLLBACK を使用するには、まず polar_enable_commit_in_execute_immediate パラメーターを有効にする必要があります。

SAVEPOINT

トランザクションにセーブポイントを設定します。後でこのポイントにロールバックできます。

構文

DBMS_TRANSACTION.SAVEPOINT(savepoint_name VARCHAR2);

パラメーター

例

DECLARE
BEGIN
    -- テストデータを挿入
    INSERT INTO test_table (id, name) VALUES (1, 'Alice');

    -- セーブポイントを設定
    DBMS_TRANSACTION.SAVEPOINT('sp1');

    -- 失敗する可能性のある操作を実行
    INSERT INTO test_table (id, name) VALUES (2, 'Bob');

    -- トランザクションをコミット
    COMMIT;
END;

ROLLBACK_SAVEPOINT

トランザクションを指定されたセーブポイントにロールバックします。これにより、セーブポイントが設定された後に行われた操作が取り消されます。

構文

DBMS_TRANSACTION.ROLLBACK_SAVEPOINT(savepoint_name VARCHAR2);

パラメーター

例

DECLARE
BEGIN
    -- 最初のレコードを挿入
    INSERT INTO test_table (id, name) VALUES (1, 'Alice');

    -- セーブポイントを設定
    DBMS_TRANSACTION.SAVEPOINT('sp1');

    -- 2 番目のレコードを挿入 (これは失敗する可能性があります)
    INSERT INTO test_table (id, name) VALUES (2, 'Bob');

    -- セーブポイント sp1 にロールバック
    DBMS_TRANSACTION.ROLLBACK_SAVEPOINT('sp1');

    -- トランザクションをコミット
    COMMIT;
END;

COMMIT

現在のトランザクションをコミットして、すべての変更を永続化します。

構文

DBMS_TRANSACTION.COMMIT();

例

DECLARE
BEGIN
    -- 2 つのレコードを挿入
    INSERT INTO test_table (id, name) VALUES (1, 'Alice');
    INSERT INTO test_table (id, name) VALUES (2, 'Bob');

    -- トランザクションをコミット
    DBMS_TRANSACTION.COMMIT();
END;

ROLLBACK

トランザクション全体をロールバックします。これにより、コミットされていないすべての変更が取り消されます。

構文

DBMS_TRANSACTION.ROLLBACK();

例

DECLARE
BEGIN
    -- 最初のレコードを挿入
    INSERT INTO test_table (id, name) VALUES (1, 'Alice');

    -- エラーをシミュレート
    IF 1 = 1 THEN
        RAISE_APPLICATION_ERROR(-20001, 'Manually triggered error');
    END IF;

    -- トランザクションをコミット (実行されません)
    DBMS_TRANSACTION.COMMIT();
EXCEPTION
    WHEN OTHERS THEN
        -- トランザクション全体をロールバック
        DBMS_TRANSACTION.ROLLBACK();
        DBMS_OUTPUT.PUT_LINE('Transaction has been rolled back');
END;