PostgreSQL 25001: トランザクションブロック内では実行できません
一部のコマンド(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))。そのため、すべてのステートメントがトランザクションの中で実行されます。 - スクリプトは複数のステートメントを 1 つの複数ステートメントのクエリ文字列として送信し、PostgreSQL はそれを 1 つの暗黙的なトランザクションとして実行します。
- コマンドを関数や
DOブロックは、常にトランザクション内で実行されます。
修正方法
-
コマンドはオートコミットを有効にしたまま単体で実行します。psqlではそれが既定です。ただし、次の間には置かないでください
BEGINそしてCOMMIT.CREATE INDEX CONCURRENTLY orders_customer_id_idx ON orders (customer_id);
-
ドライバーで、このステートメントに対して autocommit をオンにします(psycopg:
conn.autocommit = True). -
マイグレーションツールでは、マイグレーションを非トランザクションとして指定します。ほとんどのフレームワークにはそのためのオプションがあります。
-
そのようなコマンドは、ほかのコマンドと 1 つの文字列にまとめず、個別のクエリとして送信します。
安全に再現する
BEGIN; VACUUM; -- ERROR: VACUUM cannot run inside a transaction block ROLLBACK;
関連エラー
その他の無効なトランザクション状態のエラー
コードとメッセージのテキストは、 PostgreSQL ドキュメントの付録 A: PostgreSQL エラーコード。全容は次で参照 PostgreSQL エラーリスト または すべてのデータベースエラーを検索.
SQLly で PostgreSQL を操作する
macOS、Windows、Linux 用のネイティブ SQL クライアント。スキーマを認識する IntelliSense、危険なステートメントへのガードレール、分かりやすいエラーメッセージを備え、PostgreSQL をはじめ、お使いの他のデータベースにも対応します。