描述

MERGE 执行修改目标表中行（标识为target_table_name）的操作，使用data_source。 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 子句，则结果将类似于包含 RETURNING 列表中定义的列和值的 SELECT 语句，该语句在命令插入、更新或删除的行上计算。

注释

在执行 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_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 子句、BY SOURCE 和 BY TARGET 限定符到 WHEN NOT MATCHED、DO NOTHING 操作以及 RETURNING 子句是SQL标准。