↑↓ 选择↵ 打开⌫ 切换范围完整搜索

PG.CENTER 连接 PostgreSQL 文档、百科与生态知识。由 Pigsty 维护。

Wiki / SQL 命令

BEGIN

开始一个事务块

英文手册覆盖始于 PostgreSQL 6.4. 来源历史与运行验证各自保留独立版本边界。

当前阅读 PG 18·选择有来源记录的版本

anchor
SQL-BEGIN
file
sql-begin.html
lang
en
name
BEGIN
purpose
start a transaction block
purpose zh
未知
sections same as
未知
slug
18
synopsis text
BEGIN [ WORK | TRANSACTION ] [ transaction_mode [, ...] ] where transaction_mode is one of: ISOLATION LEVEL { SERIALIZABLE | REPEATABLE READ | READ COMMITTED | READ UNCOMMITTED } READ WRITE | READ ONLY [ NOT ] DEFERRABLE

语法

BEGIN [ WORK | TRANSACTION ] [ transaction_mode [, ...] ]

where transaction_mode is one of:

ISOLATION LEVEL { SERIALIZABLE | REPEATABLE READ | READ COMMITTED | READ UNCOMMITTED }
READ WRITE | READ ONLY
[ NOT ] DEFERRABLE
语法图

从左向右阅读;分支表示选择,旁路表示可选,循环表示重复。点击带下划线的参数可打开对应规则。

BEGIN WORK TRANSACTION transaction_mode ,
transaction_mode
ISOLATION LEVEL SERIALIZABLE REPEATABLE READ READ COMMITTED READ UNCOMMITTED READ WRITE READ ONLY NOT DEFERRABLE

版本定义 PG 18

BEGIN [ WORK | TRANSACTION ] [ transaction_mode [, ...] ]

其中 transaction_mode 是下列之一:

ISOLATION LEVEL { SERIALIZABLE | REPEATABLE READ | READ COMMITTED | READ UNCOMMITTED }
READ WRITE | READ ONLY
[ NOT ] DEFERRABLE

描述

BEGIN启动一个事务块,也就是说,在 BEGIN命令之后的所有语句都会在同一个事务中执行,直到显式给出COMMIT或 ROLLBACK为止。默认情况下(不使用BEGIN),PostgreSQL以“自动提交”模式执行事务,也就是说,每条语句都在自己的事务中执行,并在语句结束时隐式提交(如果执行成功,否则回滚)。

在事务块中执行语句通常会更快,因为事务的启动和提交需要大量的 CPU 和磁盘活动。在进行多个相关更改时,把多条语句放在一个事务中执行也有助于保证一致性:其他会话将无法看到那些相关更新尚未全部完成时的中间状态。

如果指定了隔离级别、读写模式或可延迟模式,新事务就会具有这些特征,就像执行了 SET TRANSACTION一样。

参数

WORK
TRANSACTION

可选关键字,没有任何作用。

关于本语句其他参数含义的信息,参见SET TRANSACTION。

注解

START TRANSACTION 与BEGIN具有相同功能。

使用COMMIT或 ROLLBACK 可以结束一个事务块。

如果在已经处于事务块中时发出BEGIN,将会产生一条警告消息。事务状态不会受影响。若要在事务块中实现事务嵌套,请使用保存点(参见SAVEPOINT)。

出于向后兼容的考虑,连续多个transaction_modes 之间的逗号可以省略。

示例

开始一个事务块:

BEGIN;

兼容性

BEGIN是PostgreSQL的一种语言扩展。它等价于 SQL 标准命令 START TRANSACTION,后者的参考页中包含更多兼容性信息。

DEFERRABLE transaction_mode 是PostgreSQL的一种语言扩展。

另外,在嵌入式 SQL 中,关键字BEGIN用于不同的目的。在移植数据库应用程序时,应当谨慎处理事务语义。

另见

COMMIT, ROLLBACK, START TRANSACTION, SAVEPOINT

比较版本

完整来源事实

synopsis html

BEGIN [ WORK | TRANSACTION ] [ <em class="replaceable"><code>transaction_mode</code></em> [, ...] ]

<span class="phrase">where <em class="replaceable"><code>transaction_mode</code></em> is one of:</span>

    ISOLATION LEVEL { SERIALIZABLE | REPEATABLE READ | READ COMMITTED | READ UNCOMMITTED }
    READ WRITE | READ ONLY
    [ NOT ] DEFERRABLE

来源引用

完整定义与证据 JSON

定义来源

center · PostgreSQL 18 · a709ab85

正文语言: zh-Hans · 1b5ca64c