输出

完成之后，MERGE 命令会返回以下形式的命令标签

MERGE total_count

total_count 为已更改行的总数（已插入、已更新或已删除）。如果 total_count 为 0，则没有任何行进行任何更改。

如果 MERGE 命令包含 RETURNING 子句，结果将类似于包含在 RETURNING 列表中定义的列和值且针对通过命令插入、更新或删除的行进行计算的 SELECT 语句的结果。

注意

执行 MERGE 时，会执行以下步骤。

总之，当我们指定那种类型的操作时，事件类型（例如，INSERT）的语句触发器将被触发。相反，行级触发器仅对正在执行的特定事件类型触发。因此，MERGE 命令可能会对 UPDATE 和 INSERT 触发语句触发器，即使只触发了 UPDATE 行触发器。

您应该确保联接为每个目标行最多生成一个候选更改行。换句话说，目标行不应联接到多个数据源行。如果联接，那么只有候选更改行才会用来修改目标行；以后修改该行的尝试将导致错误。如果行触发器对目标表进行更改，并且修改行之后也由 MERGE 修改，也会发生这种情况。如果重复操作是 INSERT，则会发生唯一性冲突，而重复的 UPDATE or DELETE 会导致基数冲突；后者是SQL标准要求。这与 UPDATE 和 DELETE 语句中 PostgreSQL 联接的历史行为不同，在这些语句中，第二次及随后尝试修改同一行会被简单忽略。

如果 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_accounts 执行维护操作。

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标准。