PREPARE TRANSACTION(7)

NAME
PREPARE TRANSACTION - 二相コミット用に現在のトランザクションを準備する

SYNOPSIS

PREPARE TRANSACTION transaction_id

説明

PREPARE TRANSACTIONは、二相コミット用に現在のトランザクションを準備します。 このコマンドの後、トランザクションは現在のセッションと関連しなくなります。 トランザクションの状態は完全にディスク上に保存され、コミット要求前にデータベースがクラッシュしてしまったとしても、ほとんど確実に正常にコミットできるようになります。

準備された後、そのトランザクションをCOMMIT PREPARED [commit_prepared(7)]やROLLBACK PREPARED [rollback_prepared(7)]によりコミットまたはロールバックすることができます。 元のトランザクションを実行したセッションだけではなく、任意のトランザクションからこれらのコマンドを発行することができます。

コマンドを発行したセッションから見ると、PREPARE TRANSACTIONはROLLBACKコマンドと似たような動作をします。 実行した後、実行中の現在のトランザクションはなくなり、準備したトランザクションの効果は不可視になります。 （そのトランザクションがコミットされた場合に効果が可視になります。）

何らかの原因でPREPARE TRANSACTIONコマンドが失敗した場合、ROLLBACKが行われます。 つまり、現在のトランザクションが取り消されます。

パラメータ

transaction_id
    後でCOMMIT PREPAREDやROLLBACK PREPAREDでトランザクションを識別するための任意の識別子です。 この識別子は文字列リテラルでなければなりません。また、200バイト未満でなければなりません。 また、その時点で準備されたトランザクションとして使用されている他の識別子と同じものは使用できません。

注釈

このコマンドはトランザクションブロック内で使用しなければなりません。 トランザクションブロックを始めるには、BEGIN [begin(7)]を使用してください。

現時点では、一時テーブルを含む操作を行うトランザクションやカーソルをWITH HOLDで作成するトランザクション、LISTENまたはUNLISTENを実行するトランザクションをPREPAREさせることはできません。 準備したトランザクションで便利に使用するには、これらの機能は現在のセッションにあまりに強く結びついているためです。

トランザクションで何らかの実行時パラメータが（LOCALオプションなしの）SETで設定されている場合、その影響はPREPARE TRANSACTIONの後も残ります。 また、COMMIT PREPAREDやROLLBACK PREPAREDの後では、その影響はありません。 したがって、この意味では、PREPARE TRANSACTION はROLLBACKよりCOMMITと似た動きであるといえます。

その時点で利用できるすべての準備されたトランザクションはpg_prepared_xactsシステムビューで列挙されます。

    Caution:

    トランザクションを長期間準備された状態のままとすることは勧められません。 これは格納領域を回収するVACUUM機能と相互作用し、極端な場合では、トランザクションの周回（in the documentation参照）を回避するためにデータベースを停止させてしまいます。 またトランザクションが保持している何からのロックを保持し続けていることにも注意してください。 外部トランザクションマネージャが他のデータベースがコミットの準備をしたと検証した後すぐに、準備されたトランザクションは通常コミットまたはロールバックされることがこの機能の想定している使用方法です。

    準備されたトランザクションを追跡し、その終了を即座に確認できるように外部トランザクションマネージャを設定していない場合、max_prepared_transactionsをゼロに設定して準備されたトランザクション機能を無効にしておくことが最善です。 こうすれば事故により準備されたトランザクションが作成され、忘れられた結果問題を引き起こすことを防ぐことができます。

例

二相コミット用に現在のトランザクションを準備します。 トランザクション識別子としてfoobarを使用します。

PREPARE TRANSACTION 'foobar';

関連項目
COMMIT PREPARED [commit_prepared(7)], ROLLBACK PREPARED [rollback_prepared(7)]