描述

MERGE 使用 data_source 对由 target_table_name 标识的目标表中的行执行修改动作。MERGE 提供了一条单独的 SQL 语句，可按条件对行执行 INSERT、UPDATE 或 DELETE；否则，这项工作需要多条过程语言语句。

首先，MERGE 命令会将 data_source 与目标表执行连接，生成零个或多个候选变更行。对于每个候选变更行，系统只会确定一次其状态是 MATCHED、NOT MATCHED BY SOURCE 还是 NOT MATCHED [BY TARGET]，然后按指定顺序对 WHEN 子句求值。对于每个候选变更行，只执行第一个求值为真的子句。任何候选变更行都不会执行多个 WHEN 子句。

MERGE 中的各个动作，与常规的 UPDATE、INSERT 或 DELETE 同名命令具有相同效果。不过这些动作的语法有所不同，尤其是没有 WHERE 子句，也不指定表名。所有动作都针对目标表，不过也可以借助触发器修改其他表。

当指定 DO NOTHING 时，源行会被跳过。由于动作会按其指定顺序求值，DO NOTHING 有助于在进行更细粒度处理之前跳过不需要关注的源行。

可选的 RETURNING 子句会让 MERGE 针对每个被插入、更新或删除的行计算并返回值。可以计算任何使用源表或目标表列的表达式，也可以调用 merge_action() 函数。执行 INSERT 或 UPDATE 动作时，使用目标表各列的新值；执行 DELETE 动作时，使用目标表各列的旧值。RETURNING 列表的语法与 SELECT 的输出列表完全相同。

没有单独的 MERGE 权限。如果指定更新动作，则必须对目标表中 SET 子句所引用的列具有 UPDATE 权限。如果指定插入动作，则必须对目标表具有 INSERT 权限。如果指定删除动作，则必须对目标表具有 DELETE 权限。如果指定 DO NOTHING 动作，则必须对目标表中至少一列具有 SELECT 权限。对于 data_source 以及目标表中在任何 condition（包括 join_condition）或 expression 中引用的列，你还必须具有 SELECT 权限。权限只会在语句开始时测试一次，而且无论特定的 WHEN 子句是否执行，都会进行检查。

如果目标表是物化视图、外部表，或者其上定义了任何规则，则不支持 MERGE。

参数

输出

成功完成时，MERGE 命令返回如下形式的命令标签：

MERGE total_count

total_count 是发生变化的总行数（无论是插入、更新还是删除）。如果 total_count 为 0，则没有任何行以任何方式发生变化。

如果 MERGE 命令包含 RETURNING 子句，则其结果将类似于一条 SELECT 语句，包含 RETURNING 列表中定义的列和值，这些值是针对该命令插入、更新或删除的行计算得到的。

注解

在执行 MERGE 期间会发生以下步骤：

总之，只要我们指定了某种动作，对应事件类型（例如 INSERT）的语句级触发器就会被触发。相反，行级触发器只会针对实际被执行的特定事件类型触发。因此，一条 MERGE 命令可能同时触发 UPDATE 和 INSERT 的语句级触发器，即使实际上只触发了 UPDATE 的行级触发器。

你应确保该连接对每个目标行最多只生成一个候选变更行。换句话说，一个目标行不应连接到多于一个数据源行。如果发生这种情况，则只会使用其中一个候选变更行来修改目标行；随后再次尝试修改该行会导致错误。如果行级触发器对目标表进行了修改，而随后这些已被修改的行又被 MERGE 再次修改，也可能发生这种情况。如果重复的动作是 INSERT，则会导致唯一性违例错误；而重复的 UPDATE 或 DELETE 则会导致基数违规；后者是 SQL 标准要求的行为。这不同于 PostgreSQL 历史上在 UPDATE 和 DELETE 语句中处理连接的行为：对同一行的第二次及后续修改尝试会被直接忽略。

如果某个 WHEN 子句省略了 AND 子句，它就会成为该类型（MATCHED、NOT MATCHED BY SOURCE 或 NOT MATCHED [BY TARGET]）最后一个可达的子句。如果之后又指定了同一类型的 WHEN 子句，则可证明它不可达，并会引发错误。如果这三类中都没有指定最后一个可达子句，则候选变更行可能不会执行任何动作。

默认情况下，从数据源生成行的顺序是不确定的。如果需要，可以使用 source_query 指定一致的排序，这可能有助于避免并发事务之间的死锁。

当 MERGE 与其他修改目标表的命令并发运行时，适用通常的事务隔离规则；请参见第 13.2 节，了解各个隔离级别下的行为说明。你也可以考虑使用 INSERT ... ON CONFLICT 作为替代语句，它提供了在发生并发 INSERT 时执行 UPDATE 的能力。这两种语句类型之间存在各种差异和限制，因此不能互换。

示例

根据新的 recent_transactions 对 customer_account 执行维护。

MERGE INTO customer_account ca
USING recent_transactions t
ON t.customer_id = ca.customer_id
WHEN MATCHED THEN
  UPDATE SET balance = balance + transaction_value
WHEN NOT MATCHED THEN
  INSERT (customer_id, balance)
  VALUES (t.customer_id, t.transaction_value);

请注意，这与下面的语句完全等价，因为 MATCHED 结果在执行期间不会改变。

MERGE INTO customer_account ca
USING (SELECT customer_id, transaction_value FROM recent_transactions) AS t
ON t.customer_id = ca.customer_id
WHEN MATCHED THEN
  UPDATE SET balance = balance + transaction_value
WHEN NOT MATCHED THEN
  INSERT (customer_id, balance)
  VALUES (t.customer_id, t.transaction_value);

尝试插入一个新的库存项及其库存数量。如果该项已存在，则改为更新现有项的库存数量。不允许库存为零的条目。返回所有已发生更改的详细信息。

MERGE INTO wines w
USING wine_stock_changes s
ON s.winename = w.winename
WHEN NOT MATCHED AND s.stock_delta > 0 THEN
  INSERT VALUES(s.winename, s.stock_delta)
WHEN MATCHED AND w.stock + s.stock_delta > 0 THEN
  UPDATE SET stock = w.stock + s.stock_delta
WHEN MATCHED THEN
  DELETE
RETURNING merge_action(), w.*;

例如，wine_stock_changes 表可能是一个刚装载到数据库中的临时表。

根据替换后的酒单更新 wines：为任何新库存插入行，更新已修改的库存条目，并删除新列表中不存在的任何葡萄酒。

MERGE INTO wines w
USING new_wine_list s
ON s.winename = w.winename
WHEN NOT MATCHED BY TARGET THEN
  INSERT VALUES(s.winename, s.stock)
WHEN MATCHED AND w.stock != s.stock THEN
  UPDATE SET stock = s.stock
WHEN NOT MATCHED BY SOURCE THEN
  DELETE;

兼容性

这个命令符合 SQL 标准。

WITH 子句、WHEN NOT MATCHED 上的 BY SOURCE 和 BY TARGET 限定词、DO NOTHING 动作以及 RETURNING 子句，都是对 SQL 标准的扩展。