// PostgreSQL エラーリファレンス

PostgreSQL 25001: トランザクションブロック内では実行できません

一部のコマンド(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))。そのため、すべてのステートメントがトランザクションの中で実行されます。
  • スクリプトは複数のステートメントを 1 つの複数ステートメントのクエリ文字列として送信し、PostgreSQL はそれを 1 つの暗黙的なトランザクションとして実行します。
  • コマンドを関数や DO ブロックは、常にトランザクション内で実行されます。

修正方法

  1. コマンドはオートコミットを有効にしたまま単体で実行します。psqlではそれが既定です。ただし、次の間には置かないでください BEGIN そして COMMIT.

    CREATE INDEX CONCURRENTLY orders_customer_id_idx ON orders (customer_id);
  2. ドライバーで、このステートメントに対して autocommit をオンにします(psycopg: conn.autocommit = True).

  3. マイグレーションツールでは、マイグレーションを非トランザクションとして指定します。ほとんどのフレームワークにはそのためのオプションがあります。

  4. そのようなコマンドは、ほかのコマンドと 1 つの文字列にまとめず、個別のクエリとして送信します。

安全に再現する

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

関連エラー

その他の無効なトランザクション状態のエラー

コードとメッセージのテキストは、 PostgreSQL ドキュメントの付録 A: PostgreSQL エラーコード。全容は次で参照 PostgreSQL エラーリスト または すべてのデータベースエラーを検索.

// エラーが減り、修正も速く

SQLly で PostgreSQL を操作する

macOS、Windows、Linux 用のネイティブ SQL クライアント。スキーマを認識する IntelliSense、危険なステートメントへのガードレール、分かりやすいエラーメッセージを備え、PostgreSQL をはじめ、お使いの他のデータベースにも対応します。