描述

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_item列表中提到的表连接起来，而连接 的每一条输出行都代表对目标表的一次更新操作。使用 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');

更新账户表中的联系人姓名，使其与当前分配的销售人员保持一致：

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

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

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

但是，第二个查询可能会给出意外结果，如果 salesmen.id 不是唯一键的话；而第一个查询在存在多个 id 匹配时保证会报错。此外，如果某个特定的 accounts.sales_id 条目没有匹配项，第一个查询会把相应的姓名字段设为 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;

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

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

兼容性

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

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

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