描述

MERGE 使用 data_source 执行修改目标表（标识为 target_table_name）中行的操作。MERGE 提供一个单一的SQL语句，它可以有条件地 INSERT、UPDATE 或 DELETE 行，否则这将需要多个过程语言语句才能完成。

首先，MERGE 命令执行从 data_source 到目标表的连接，生成零个或多个候选更改行。对于每个候选更改行，MATCHED、NOT MATCHED BY SOURCE 或 NOT MATCHED [BY TARGET] 的状态只设置一次，之后按照指定的顺序评估 WHEN 子句。对于每个候选更改行，执行评估为 true 的第一个子句。对于任何候选更改行，最多执行一个 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 权限。您还需要对任何 condition（包括 join_condition）或 expression 中引用的 data_source 和目标表的任何列具有 SELECT 权限。权限在语句开始时测试一次，并检查是否执行特定的 WHEN 子句。

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

参数

Outputs

成功完成后，MERGE 命令返回一个形式为

MERGE total_count

的命令标记。 total_count 是已更改的总行数（无论是插入、更新还是删除）。如果 total_count 为 0，则没有任何行以任何方式更改。

如果 MERGE 命令包含 RETURNING 子句，则结果将类似于包含 RETURNING 列表中定义的列和值的 SELECT 语句的结果，该结果是根据命令插入、更新或删除的行计算得出的。

Notes

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

总之，当 指定 这种操作时，将触发事件类型（例如，INSERT）的语句触发器。相比之下，行级触发器仅对 执行 的特定事件类型触发。因此，即使仅触发了 UPDATE 行触发器，MERGE 命令也可能会同时触发 UPDATE 和 INSERT 的语句触发器。

您应确保该连接为每个目标行最多生成一个候选更改行。换句话说，一个目标行不应连接到多个数据源行。如果这样做，则只会使用其中一个候选更改行来修改目标行；稍后尝试修改该行将导致错误。如果行触发器对目标表进行更改，并且随后通过 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 的能力。这两种语句类型之间存在许多差异和限制，它们不可互换。

Examples

根据新的 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标准。