SQL COMMAND · 事务控制
BEGIN
开始一个事务块
start a transaction block
BEGIN事务控制引入 6.5现存至 20 devel3 次语法变更
- 动词
BEGIN- 对象
—- 分组
- 事务控制
- 引入版本
- 6.5
- 状态
- 现存
- 语法变更次数
- 3
- 手册小节数
- 6
版本轨迹
相对 PostgreSQL 17 无变化。
语法铁道图 PostgreSQL 18
沿轨道从左向右阅读,分岔表示选择,绕行表示可选,回环表示重复。方框为参数,点击带下划线的参数可展开子规则。
transaction_mode
语法概要
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 一样。
参数
WORKTRANSACTION可选关键字,没有任何作用。
关于本语句其他参数含义的信息,参见 SET TRANSACTION。
注解
START TRANSACTION
与 BEGIN 具有相同功能。
使用 COMMIT 或
ROLLBACK
可以结束一个事务块。
如果在已经处于事务块中时发出 BEGIN,将会产生一条警告消息。事务状态不会受影响。若要在事务块中实现事务嵌套,请使用保存点(参见 SAVEPOINT)。
出于向后兼容的考虑,连续多个 transaction_modes
之间的逗号可以省略。
示例
开始一个事务块:
BEGIN;
兼容性
BEGIN 是 PostgreSQL 的一种语言扩展。它等价于 SQL 标准命令
START TRANSACTION,后者的参考页中包含更多兼容性信息。
DEFERRABLE
transaction_mode
是 PostgreSQL 的一种语言扩展。
另外,在嵌入式 SQL 中,关键字 BEGIN 用于不同的目的。在移植数据库应用程序时,应当谨慎处理事务语义。
另见
语法演化
相邻大版本之间的差异,新的在前。版本号链接到对应快照。
PostgreSQL 10← 9.6正文更新
正文更新PostgreSQL 9.1← 9.0语法变化
+ [ NOT ] DEFERRABLE正文更新PostgreSQL 9.0← 8.4语法变化
− where transaction_mode is one of:PostgreSQL 8.3← 8.2正文更新
正文更新PostgreSQL 8.2← 8.1正文更新
正文更新PostgreSQL 8.0← 7.4语法变化
+ BEGIN [ WORK | TRANSACTION ] [ transaction_mode [, ...] ]+ where transaction_mode is one of:+ ISOLATION LEVEL { SERIALIZABLE | REPEATABLE READ | READ COMMITTED | READ UNCOMMITTED }+ READ WRITE | READ ONLY正文更新PostgreSQL 7.4← 7.3正文更新
正文更新PostgreSQL 7.3← 7.2正文更新
正文更新PostgreSQL 7.2← 7.1正文更新
正文更新PostgreSQL 7.1← 7.0文件改名
sql-begin.htm → sql-begin.html
正文更新PostgreSQL 7.0← 6.5文件改名
sql-beginwork.htm → sql-begin.htm
正文更新PostgreSQL 6.5← 6.4新增此命令
同组命令
| 命令 | 动词 | 对象 | 版本变动 | 最近变更 |
|---|---|---|---|---|
ABORT | ABORT | — | 123 次 | |
| 中止当前事务 | 现存 | |||
BEGIN | BEGIN | — | 9.13 次 | |
| 开始一个事务块 | 现存 | |||
COMMIT | COMMIT | — | 121 次 | |
| 提交当前事务 | 现存 | |||
END | END | — | 121 次 | |
| 提交当前事务 | 现存 | |||
ROLLBACK | ROLLBACK | — | 122 次 | |
| 中止当前事务 | 现存 | |||
SAVEPOINT | SAVEPOINT | — | — | |
| 在当前事务中定义一个新的保存点 | 现存 | |||
WAIT | WAIT | — | — | |
| 等待 WAL 达到目标 LSN | 现存 | |||
SET CONSTRAINTS | SET | CONSTRAINTS | 7.41 次 | |
| 为当前事务设置约束检查时机 | 现存 | |||
COMMIT PREPARED | COMMIT | PREPARED | — | |
| 提交一个先前为两阶段提交而预备的事务 | 现存 | |||
ROLLBACK PREPARED | ROLLBACK | PREPARED | — | |
| 回滚一个先前为两阶段提交而预备的事务 | 现存 | |||
RELEASE SAVEPOINT | RELEASE | SAVEPOINT | — | |
| 释放一个先前定义的保存点 | 现存 | |||
ROLLBACK TO SAVEPOINT | ROLLBACK | TO SAVEPOINT | — | |
| 回滚到一个保存点 | 现存 | |||
PREPARE TRANSACTION | PREPARE | TRANSACTION | — | |
| 为两阶段提交准备当前事务 | 现存 | |||
SET TRANSACTION | SET | TRANSACTION | 9.25 次 | |
| 设置当前事务的特性 | 现存 | |||
START TRANSACTION | START | TRANSACTION | 9.14 次 | |
| 开始一个事务块 | 现存 | |||
BEGIN WORK | BEGIN | WORK | — | |
| 开始一个事务 | 于 6.5 移除 | |||