// PostgreSQL 錯誤參考

PostgreSQL 2D000:無效的交易終止

在無法控制交易的程序或 DO 區塊內執行了 COMMIT 或 ROLLBACK,例如在明確交易中呼叫,或從函式內呼叫。

SQLSTATE
2D000
名稱
invalid_transaction_termination
類別
無效的交易終止
錯誤訊息
invalid transaction termination

它的意義

自 PostgreSQL 11 起,程序(CALL)和 DO 區塊可執行 COMMIT 和 ROLLBACK。這只有在最上層呼叫它們時才行得通,在呼叫者自己開啟的交易裡則不行。如果程序是在 BEGIN,從函式、從觸發器,或從把它包進交易的路徑過來時,它的 COMMIT 會以 2D000 失敗。

函式永遠無法認可或回復;它們的工作一律屬於呼叫端交易的一部分。

常見原因

  • 呼叫程序時使用了 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 錯誤清單 或 搜尋每個資料庫錯誤.

// 錯誤更少,修復更快

在 SQLly 裡操作 PostgreSQL

適用於 macOS、Windows 和 Linux 的原生 SQL 客戶端,具備結構描述感知的 IntelliSense、高風險陳述式防護與清楚的錯誤訊息,適用於 PostgreSQL 和你使用的其他資料庫。