描述

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 正在对某个分区键执行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 中则不能这样做。