説明

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

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

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

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

パラメータ

注釈

PREPARE TRANSACTIONはアプリケーションや対話式のセッションでの使用を目的としていません。 この目的は、外部トランザクションマネージャにより、複数のデータベースやその他のトランザクションを持つリソースを跨るグローバルなトランザクションを原子的に実現できるようにすることです。 トランザクションマネージャを作成しているのでなければ、おそらくPREPARE TRANSACTIONを使用するべきではありません。

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

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

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

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

例

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

PREPARE TRANSACTION 'foobar';

互換性

PREPARE TRANSACTIONはPostgreSQLの拡張です。 これは外部のトランザクション管理システムによる利用を意図したものです。 トランザクション管理システムの一部（X/Open XAなど）は標準化されていますが、こうしたシステムのSQL側は標準化されていません。

関連項目