描述

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

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

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

必须拥有该表上的UPDATE权限，或者至少拥有所列待更新列的该权限。还必须拥有SELECT权限，覆盖在expressions或condition中读取其值的所有列。

参数

输出

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

UPDATE count

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

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

注解

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

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

示例

把表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;

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

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

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

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');

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

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;

更改 kind 列，该列位于表 films 中，所更改的行是游标 c_films 当前定位的行：

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

兼容性

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

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

根据标准，列列表语法应当允许从一个单一行值表达式（例如子查询）给一组列赋值：

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

这一点目前尚未实现——源必须是一个独立表达式列表。