===================
PREPARE TRANSACTION
===================


.. container:: refentry
   :name: SQL-PREPARE-TRANSACTION

   .. container:: titlepage

   .. container:: refnamediv

      .. rubric:: PREPARE TRANSACTION
         :name: prepare-transaction

      PREPARE TRANSACTION — 为两阶段提交准备当前事务

   .. container:: refsynopsisdiv

      .. rubric:: 大纲
         :name: 大纲

      .. code:: synopsis

         PREPARE TRANSACTION transaction_id

   .. container:: refsect1
      :name: id-1.9.3.159.5

      .. rubric:: 描述
         :name: 描述

      ``PREPARE TRANSACTION``\ 为两阶段提交准备
      当前事务。在这个命令之后，该事务不再与当前会话关联。相反，它的状态
      被完全存储在磁盘上，并且有很高的可能性它会被提交成功（即便在请求提
      交前发生数据库崩溃）。

      一旦被准备好，事务稍后就可以分别用 `COMMIT
      PREPARED <sql-commit-prepared.html>`__ 或者\ `ROLLBACK
      PREPARED <sql-rollback-prepared.html>`__\ 提交或者回滚。可以从任何
      会话而不仅仅是执行原始事务的会话中发出这些命令。

      从发出命令的会话的角度来看，\ ``PREPARE    TRANSACTION``\ 不像\ ``ROLLBACK``\ 命令：
      在执行它之后，就没有活跃的当前事务，并且该预备事务的效果也不再可见（
      如果该事务被提交，效果将重新变得可见）。

      如果由于任何原因\ ``PREPARE TRANSACTION``
      命令失败，它会变成一个\ ``ROLLBACK``\ ：当前事务会被取消。

   .. container:: refsect1
      :name: id-1.9.3.159.6

      .. rubric:: 参数
         :name: 参数

      .. container:: variablelist

         *``transaction_id``*
            一个任意的事务标识符，
            ``COMMIT PREPARED``\ 或者\ ``ROLLBACK PREPARED``
            以后将用这个标识符来标识这个事务。该标识符必须写成一个字符串，
            并且长度必须小于 200
            字节。它也不能与任何当前已经准备好的事务的标识符相同。

   .. container:: refsect1
      :name: id-1.9.3.159.7

      .. rubric:: 注解
         :name: 注解

      ``PREPARE TRANSACTION``\ 并不是设计为在应用或者交互式
      会话中使用。它的目的是允许一个外部事务管理器在多个数据库或者其他事务性
      来源之间执行原子的全局事务。除非你在编写一个事务管理器，否则你可能不会
      用到\ ``PREPARE TRANSACTION``\ 。

      这个命令必须在一个事务块中使用。事务块用\ `BEGIN <sql-begin.html>`__\ 开始。

      当前在已经执行过任何涉及到临时表或者会话的临时命名空间、创建带
      ``WITH HOLD``\ 的游标或者执行
      ``LISTEN``\ 、\ ``UNLISTEN``\ 或\ ``NOTIFY``\ 的
      事务中，不允许\ ``PREPARE``\ 该事务。这些特性与当前会话
      绑定得太过紧密，所以对一个要被准备的事务来说没有什么用处。

      如果用\ ``SET``\ （不带\ ``LOCAL``\ 选项）修改过事务的
      任何运行时参数，这些效果会持续到
      ``PREPARE TRANSACTION``\ 之后，并且将不会被后续的任何
      ``COMMIT PREPARED``\ 或
      ``ROLLBACK PREPARED``\ 所影响。因此，在这一
      方面\ ``PREPARE TRANSACTION``\ 的行为更像
      ``COMMIT``\ 而不是\ ``ROLLBACK``\ 。

      所有当前可用的准备好事务被列在\ ```pg_prepared_xacts`` <view-pg-prepared-xacts.html>`__\ 系统视图中。

      .. caution::

         .. rubric:: 小心
            :name: 小心
            :class: title

         让一个事务处于准备好状态太久是不明智的。这将会干扰
         ``VACUUM``\ 回收存储的能力，并且在极限情况下可能导致
         数据库关闭以阻止事务 ID
         回卷。还要记住，该事务会继续持有
         它已经持有的锁。该特性的设计用法是，只要一个外部事务管理器已经验证
         其他数据库也准备好了要提交，一个准备好的事务将被正常地提交或者回滚。

         如果没有建立一个外部事务管理器来跟踪准备好的事务并且确保它们被迅速地
         结束，最好禁用准备好事务特性（设置
         max_prepared_transactions为零）。这将防止意外
         地创建准备好事务，不然该事务有可能被忘记并且最终导致问题。

   .. container:: refsect1
      :name: SQL-PREPARE-TRANSACTION-EXAMPLES

      .. rubric:: 例子
         :name: 例子

      为两阶段提交准备当前事务，使用\ ``foobar``\ 作为事务标识符：

      .. code:: programlisting

         PREPARE TRANSACTION 'foobar';

   .. container:: refsect1
      :name: id-1.9.3.159.9

      .. rubric:: 兼容性
         :name: 兼容性

      ``PREPARE TRANSACTION``\ 是一种 PostgreSQL扩展。其意图是用于
      外部事务管理系统，其中有些已经被标准涵盖（例如 X/Open XA），
      但是那些系统的 SQL 方面未被标准化。

   .. container:: refsect1
      :name: id-1.9.3.159.10

      .. rubric:: 另见
         :name: 另见

      `COMMIT PREPARED <sql-commit-prepared.html>`__, `ROLLBACK
      PREPARED <sql-rollback-prepared.html>`__