PostgreSQL 25001:無法在交易區塊內執行 - SQLly
某些命令(VACUUM、CREATE DATABASE、CREATE INDEX CONCURRENTLY、ALTER SYSTEM)必須單獨執行,不能包在 BEGIN ... COMMIT 裡。
- SQLSTATE
25001- 名稱
active_sql_transaction- 類別
- 無效的交易狀態
它的意義
少數 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區塊,而它總是在交易內執行。
如何修正
-
單獨執行該命令,並保持自動認可開啟。在 psql 中這是預設行為;只要別把它放在
BEGIN和COMMIT.CREATE INDEX CONCURRENTLY orders_customer_id_idx ON orders (customer_id);
-
在你的驅動程式中,對這個陳述式開啟自動提交(psycopg:
conn.autocommit = True). -
在遷移工具中,將遷移標記為非交易性的;大多數框架都有這個選項。
-
將每個這類命令當作獨立的查詢傳送,不要與其他命令合併在同一個字串裡。
安全地重現問題
BEGIN; VACUUM; -- ERROR: VACUUM cannot run inside a transaction block ROLLBACK;
相關錯誤
更多無效的交易狀態錯誤
程式碼和訊息文字來自 PostgreSQL 文件,附錄 A:PostgreSQL 錯誤碼。瀏覽完整的 PostgreSQL 錯誤清單 或 搜尋每個資料庫錯誤.
在 SQLly 裡操作 PostgreSQL
適用於 macOS、Windows 和 Linux 的原生 SQL 客戶端,具備結構描述感知的 IntelliSense、高風險陳述式防護與清楚的錯誤訊息,適用於 PostgreSQL 和你使用的其他資料庫。