// PostgreSQL 錯誤參考

PostgreSQL 25001:無法在交易區塊內執行 - SQLly

某些命令(VACUUM、CREATE DATABASE、CREATE INDEX CONCURRENTLY、ALTER SYSTEM)必須單獨執行,不能包在 BEGIN ... COMMIT 裡。

SQLSTATE
25001
名稱
active_sql_transaction
類別
無效的交易狀態
錯誤訊息
CREATE INDEX CONCURRENTLY cannot run inside a transaction block

它的意義

少數 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 區塊,而它總是在交易內執行。

如何修正

  1. 單獨執行該命令,並保持自動認可開啟。在 psql 中這是預設行為;只要別把它放在 BEGIN 和 COMMIT.

    CREATE INDEX CONCURRENTLY orders_customer_id_idx ON orders (customer_id);
  2. 在你的驅動程式中,對這個陳述式開啟自動提交(psycopg: conn.autocommit = True).

  3. 在遷移工具中,將遷移標記為非交易性的;大多數框架都有這個選項。

  4. 將每個這類命令當作獨立的查詢傳送,不要與其他命令合併在同一個字串裡。

安全地重現問題

BEGIN;
VACUUM;  -- ERROR: VACUUM cannot run inside a transaction block
ROLLBACK;

相關錯誤

更多無效的交易狀態錯誤

程式碼和訊息文字來自 PostgreSQL 文件,附錄 A:PostgreSQL 錯誤碼。瀏覽完整的 PostgreSQL 錯誤清單 或 搜尋每個資料庫錯誤.

// 錯誤更少,修復更快

在 SQLly 裡操作 PostgreSQL

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