↑↓ 选择 ↵ 打开 ⌫ 改范围 完整检索页

pgsql.cc 提供对 postgresql.org 官网内容的中文翻译,由 Pigsty 团队维护。

百科 / SQL 命令 / 查询与数据操作

SQL COMMAND · 查询与数据操作

UPDATE

更新表中的行

UPDATE查询与数据操作引入 10(基线)现存至 20 devel2 次语法变更

动词
UPDATE
对象
—
引入版本
10(基线)
状态
现存
语法变更次数
2
手册小节数
6

本站手册 · 18官方文档 ↗

版本轨迹

相对 PostgreSQL 17:语法概要新增 1 行,移除 0 行。

语法铁道图 PostgreSQL 18

沿轨道从左向右阅读,分岔表示选择,绕行表示可选,回环表示重复。方框为参数,点击带下划线的参数可展开子规则。

WITH RECURSIVE with_query , UPDATE ONLY table_name * AS alias SET column_name = expression DEFAULT ( column_name , ) = ROW ( expression DEFAULT , ) ( column_name , ) = ( sub-SELECT ) , FROM from_item , WHERE condition WHERE CURRENT OF cursor_name RETURNING WITH ( OLD NEW AS output_alias , ) * output_expression AS output_name ,

锁模式 PostgreSQL 18

具体锁模式取决于操作变体、目标对象和执行阶段;同一命令可同时取得表锁与行锁。查看完整冲突矩阵

ROW SHARE · 表级锁

UPDATE(外键检查):外键检查的内部 SELECT … FOR KEY SHARE 在被引用表上取得 ROW SHARE;写入目标表上的模式仍是 ROW EXCLUSIVE。

ROW EXCLUSIVE · 表级锁

UPDATE:目标表取得此模式;受影响的已有行另有行锁。

UPDATE(不修改键值):这个写入变体在目标表上取得 ROW EXCLUSIVE;对已有行的锁另按实际动作取得。

UPDATE(修改键值):这个写入变体在目标表上取得 ROW EXCLUSIVE;对已有行的锁另按实际动作取得。

UPDATE(外键检查):原始写入命令在写入目标表上取得 ROW EXCLUSIVE;外键检查的 ROW SHARE 与 FOR KEY SHARE 则作用于被引用的表和行,不能混为同一对象。

FOR KEY SHARE · 行级锁

UPDATE(外键检查):实际检查非空外键引用时,在被引用表的匹配行上取得 FOR KEY SHARE;可能在语句内或延迟约束检查时执行。级联动作还会取得相应 UPDATE / DELETE 的锁。

FOR NO KEY UPDATE · 行级锁

UPDATE(不修改键值):没有取得 FOR UPDATE 的 UPDATE 使用此模式。此处的键列是可供外键引用的唯一索引列,不包括部分索引与表达式索引。

FOR UPDATE · 行级锁

UPDATE(修改键值):修改可供外键引用的唯一索引列时使用;部分索引和表达式索引不算在内。

语法概要

相对 PostgreSQL 17 新增 1 行,移除 0 行;新增行以绿色标记。

[ WITH [ RECURSIVE ] with_query [, ...] ]
UPDATE [ ONLY ] table_name [ * ] [ [ AS ] alias ]
    SET { column_name = { expression | DEFAULT } |
          ( column_name [, ...] ) = [ ROW ] ( { expression | DEFAULT } [, ...] ) |
          ( column_name [, ...] ) = ( sub-SELECT )
        } [, ...]
    [ FROM from_item [, ...] ]
    [ WHERE condition | WHERE CURRENT OF cursor_name ]
    [ RETURNING [ WITH ( { OLD | NEW } AS output_alias [, ...] ) ]
                { * | output_expression [ [ AS ] output_name ] } [, ...] ]

PostgreSQL 18 手册 · 查看完整参考页

描述

UPDATE会更改所有满足条件的行中指定列的值。只需在SET子句中提及需要修改的列;未被显式修改的列会保留其原有值。

有两种方法可以利用数据库中其他表所包含的信息来修改一个表:使用子选择,或者在FROM子句中指定附加表。哪种技术更合适取决于具体情况。

可选的RETURNING子句使UPDATE 基于每个实际更新的行计算并返回一个或多个值。可以计算任何使用该表列和/或 FROM中提到的其他表列的表达式。默认使用该表列的新值(更新后值),但也可以请求旧值(更新前值)。RETURNING列表的语法与SELECT 的输出列表相同。

必须拥有该表上的UPDATE权限,或者至少拥有待更新列的UPDATE权限。对于其值会在 expressions或者 condition中读取的任何列,还必须拥有SELECT权限。

参数

with_query

WITH子句允许你指定一个或多个子查询,这些子查询可在UPDATE查询中按名称引用。详见第 7.8 节和SELECT。

table_name

要更新的表名(可以是模式限定的)。如果在表名前指定了 ONLY,只会更新所提及表中的匹配行。如果未指定 ONLY,还会更新继承自该表的任何表中的匹配行。可选地,可以在表名后指定*,以显式指示包含后代表。

alias

目标表的替代名称。提供别名时,它会完全隐藏该表的实际名称。例如,给定UPDATE foo AS f,UPDATE语句的其余部分必须将该表称为 f,而不是foo。

column_name

由table_name命名的表中的列名。如有需要,列名可以使用子字段名或数组下标进行限定。指定目标列时不要包含表名 — 例如,UPDATE table_name SET table_name.col = 1是无效的。

expression

要赋给该列的表达式。该表达式可以使用该表中这一列和其他列的旧值。

DEFAULT

把该列设置为其默认值(如果没有为它指定特定的默认表达式,则该值为 NULL)。标识列将被设置为由关联序列生成的新值。对于生成列,允许指定这一项,但这仅仅指定了根据其生成表达式计算该列的常规行为。

sub-SELECT

一个SELECT子查询,其输出列数必须与它前面圆括号中列列表的列数相同。执行时,该子查询返回的行数不得超过一行。如果返回一行,则其列值会赋给目标列;如果不返回任何行,则把 NULL 值赋给目标列。该子查询可以引用正在更新的表的当前行的旧值。

from_item

一个表表达式,允许其他表的列出现在WHERE条件和更新表达式中。这里使用的语法与SELECT语句的FROM子句相同;例如,可以为表名指定别名。除非你打算进行自连接(这种情况下它必须在from_item中带有别名出现),否则不要把目标表重复写成from_item。

condition

一个返回boolean类型值的表达式。只有使这个表达式返回true的行才会被更新。

cursor_name

要在WHERE CURRENT OF条件中使用的游标名。要被更新的行是最近一次从该游标中取出的那一行。该游标必须是针对UPDATE目标表的非分组查询。注意,WHERE CURRENT OF不能与布尔条件同时指定。有关将游标用于WHERE CURRENT OF的更多信息,请见DECLARE。

output_alias

在RETURNING列表中为OLD或 NEW行指定的可选替代名称。

默认情况下,可通过 OLD.column_name 或OLD.*返回目标表旧值,通过 NEW.column_name 或NEW.*返回新值。提供别名后,这些名称会被隐藏,必须使用别名来引用旧行或新行。例如 RETURNING WITH (OLD AS o, NEW AS n) o.*, n.*。

output_expression

在每一行被更新后,由UPDATE命令计算并返回的表达式。该表达式可以使用由table_name 命名的表或FROM中列出的表中的任何列名。写成 *可返回所有列。

列名或*可以用OLD或 NEW进行限定,也可以用 OLD或NEW对应的 output_alias进行限定,以返回旧值或新值。未限定的列名或*,以及使用目标表名或别名限定的列名或*,都会返回新值。

output_name

用于返回列的名称。

输出

在成功完成时,一个UPDATE命令会返回以下形式的命令标签:

UPDATE count

count是被更新的行数,包括值没有改变的匹配行。注意,当更新被BEFORE UPDATE 触发器抑制时,这个数量可能小于匹配 condition的行数。如果 count为 0,则该查询没有更新任何行(这不被视为错误)。

如果UPDATE命令包含RETURNING 子句,其结果将类似于一个SELECT语句,其中包含 RETURNING列表中定义的列和值,并在该命令更新的行上进行计算。

注解

当存在FROM子句时,本质上会将目标表与 from_item列表中提到的表连接起来,而连接的每一条输出行都代表对目标表的一次更新操作。使用 FROM时,应确保对每一个要修改的目标行,连接至多生成一条输出行。换言之,一条目标行不应与其他表中的多于一行成功连接。如果发生这种情况,则只会使用其中某一条连接行来更新目标行,但具体使用哪一条并不容易预测。

因为存在这种不确定性,所以仅在子选择中引用其他表会更安全,尽管这种写法通常比使用连接更难阅读、也更慢。

对于分区表,更新一行可能会导致它不再满足其所在分区的分区约束。在这种情况下,如果在分区树中存在另一个分区,且该行满足它的分区约束,则该行会被移动到那个分区。如果不存在这样的分区,则会报错。在幕后,行移动实际上是一次DELETE和一次 INSERT操作。

在被移动的行上并发执行UPDATE或 DELETE时,有可能收到串行化失败错误。假设会话 1 正在对某个分区键执行UPDATE,与此同时,一个能够看到该行的并发会话 2 对该行执行UPDATE或DELETE操作。在这种情况下,会话 2 的UPDATE或 DELETE将检测到行移动,并引发串行化失败错误(其 SQLSTATE 代码始终为'40001')。如果发生这种情况,应用程序可能需要重试事务。在表未分区或没有发生行移动的通常情况下,会话 2 会识别出新更新的那一行,并在这个新行版本上执行 UPDATE/DELETE。

请注意,虽然行可以从本地分区移动到外部表分区(前提是外部数据包装器支持元组路由),但不能从外部表分区移动到另一个分区。

如果发现某个外键直接引用了源分区的某个祖先,并且这个祖先与 UPDATE查询中提到的祖先不是同一个,那么尝试把一行从一个分区移动到另一个分区将会失败。

示例

把表films的kind 列中的单词Drama改为Dramatic:

UPDATE films SET kind = 'Dramatic' WHERE kind = 'Drama';

在表weather的一行中调整温度项,并将降水量重置为其默认值:

UPDATE weather SET temp_lo = temp_lo+1, temp_hi = temp_lo+15, prcp = DEFAULT
  WHERE city = 'San Francisco' AND date = '2003-07-03';

执行同样的操作,并返回更新后的各项以及旧的降水值:

UPDATE weather SET temp_lo = temp_lo+1, temp_hi = temp_lo+15, prcp = DEFAULT
  WHERE city = 'San Francisco' AND date = '2003-07-03'
  RETURNING temp_lo, temp_hi, prcp, old.prcp AS old_prcp;

使用另一种列列表语法完成同样的更新:

UPDATE weather SET (temp_lo, temp_hi, prcp) = (temp_lo+1, temp_lo+15, DEFAULT)
  WHERE city = 'San Francisco' AND date = '2003-07-03';

使用FROM子句语法,将负责 Acme Corporation 账户的销售人员的销量计数加一:

UPDATE employees SET sales_count = sales_count + 1 FROM accounts
  WHERE accounts.name = 'Acme Corporation'
  AND employees.id = accounts.sales_person;

在WHERE子句中使用子选择,执行同样的操作:

UPDATE employees SET sales_count = sales_count + 1 WHERE id =
  (SELECT sales_person FROM accounts WHERE name = 'Acme Corporation');

更新accounts表中的联系人姓名,使其与当前分配的销售人员保持一致:

UPDATE accounts SET (contact_first_name, contact_last_name) =
    (SELECT first_name, last_name FROM employees
     WHERE employees.id = accounts.sales_person);

使用连接也可以得到类似结果:

UPDATE accounts SET contact_first_name = first_name,
                    contact_last_name = last_name
  FROM employees WHERE employees.id = accounts.sales_person;

但是,如果employees.id不是唯一键,第二个查询可能会给出意外结果;而如果存在多个 id匹配,第一个查询则保证会报错。此外,如果某个特定的accounts.sales_person 条目没有匹配项,第一个查询会把相应的姓名字段设为NULL,而第二个查询则根本不会更新该行。

更新汇总表中的统计数据以匹配当前数据:

UPDATE summary s SET (sum_x, sum_y, avg_x, avg_y) =
    (SELECT sum(x), sum(y), avg(x), avg(y) FROM data d
     WHERE d.group_id = s.group_id);

尝试插入一个新库存项及其库存量。如果该项已存在,则改为更新现有项的库存量。要在不致使整个事务失败的情况下做到这一点,请使用保存点:

BEGIN;
-- 其他操作
SAVEPOINT sp1;
INSERT INTO wines VALUES('Chateau Lafite 2003', '24');
-- 假设上面的语句因唯一键冲突而失败,
-- 那么现在发出这些命令:
ROLLBACK TO sp1;
UPDATE wines SET stock = stock + 24 WHERE winename = 'Chateau Lafite 2003';
-- 继续执行其他操作,最后
COMMIT;

更改表films中游标c_films 当前定位那一行的kind列:

UPDATE films SET kind = 'Dramatic' WHERE CURRENT OF c_films;

影响很多行的更新可能对系统性能产生负面影响,例如表膨胀、复制延迟增加以及锁争用加剧。在这类场景中,将操作分成较小批次来执行可能更有意义,并且可以在各批次之间对该表执行VACUUM。虽然UPDATE没有LIMIT子句,但可以通过公共表表达式和自连接获得类似效果。对于标准的PostgreSQL 表访问方法,基于系统列ctid 的自连接非常高效:

WITH exceeded_max_retries AS (
  SELECT w.ctid FROM work_item AS w
    WHERE w.status = 'active' AND w.num_retries > 10
    ORDER BY w.retry_timestamp
    FOR UPDATE
    LIMIT 5000
)
UPDATE work_item SET status = 'failed'
  FROM exceeded_max_retries AS emr
  WHERE work_item.ctid = emr.ctid;

该命令需要重复执行,直到没有剩余行需要更新。(这里使用ctid之所以安全,仅仅是因为查询会重复运行,从而避免了ctid发生变化带来的问题。)使用ORDER BY子句可以让命令确定优先更新哪些行;如果其他更新操作也使用相同的顺序,它还可以防止死锁。如果担心锁争用,可以在CTE中加入SKIP LOCKED,以防多个命令更新同一行。不过,这样仍需要在最后执行一次不带 SKIP LOCKED或LIMIT的 UPDATE,以确保没有遗漏任何匹配行。

兼容性

这个命令符合SQL标准,不过 FROM和RETURNING子句是 PostgreSQL扩展,把WITH 与UPDATE一起使用的能力也是扩展。

某些其他数据库系统提供一种FROM选项,要求在 FROM中再次列出目标表。PostgreSQL 并不是这样解释FROM的。在移植使用这种扩展的应用时要小心。

根据标准,目标列名的一个圆括号子列表的源值可以是任何能够产生正确列数的行值表达式。PostgreSQL只允许该源值是一个行构造器或子SELECT。在行构造器的情况下,单个列的更新值可以指定为DEFAULT,但在子SELECT 中则不能这样做。

语法演化

相邻大版本之间的差异,新的在前。版本号链接到对应快照。

  1. PostgreSQL 20← 19正文更新

    正文更新
  2. PostgreSQL 19← 18正文更新

    正文更新
  3. PostgreSQL 18← 17语法变化

    + [ RETURNING [ WITH ( { OLD | NEW } AS output_alias [, ...] ) ]正文更新
  4. PostgreSQL 17← 16正文更新

    正文更新
  5. PostgreSQL 15← 14正文更新

    正文更新
  6. PostgreSQL 13← 12正文更新

    正文更新
  7. PostgreSQL 12← 11语法变化

    + [ RETURNING { * | output_expression [ [ AS ] output_name ] } [, ...] ]
  8. PostgreSQL 11← 10正文更新

    正文更新

同组命令

命令动词对象版本变动最近变更
QUERIES & DATA查询与数据操作10 条↑
COPYCOPY— 196 次
在文件和表之间复制数据现存
DELETEDELETE— 182 次
删除表中的行现存
EXPLAINEXPLAIN— 195 次
显示一个语句的执行计划现存
INSERTINSERT— 193 次
在表中插入新行现存
LOCKLOCK— —
锁定表现存
MERGEMERGE— 182 次
有条件地插入、更新或删除表中的行现存
SELECTSELECT— 176 次
从表或视图中检索行现存
UPDATEUPDATE— 182 次
更新表中的行现存
VALUESVALUES— —
计算一组行现存
SELECT INTOSELECTINTO 192 次
根据查询结果定义一个新表现存