描述

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

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

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

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

参数

输出

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

UPDATE count

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

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

注解

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

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

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

在被移动的行上并发执行UPDATE或 DELETE时，有可能收到序列化失败错误。假设会话 1 正在更新某个分区键，与此同时，一个对该行可见的并发会话 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 中则不能这样做。