描述

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);

尝试插入新库存商品以及库存数量。如果商品已存在，则更新现有商品的库存数量。不允许零库存的录入。返回所有更改的详细信息。

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.winename, old.stock AS old_stock, new.stock AS new_stock;

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;

兼容性

此命令符合SQLSQL 标准的一部分。

WITH 子句，WHEN NOT MATCHED 的 BY SOURCE 和 BY TARGET 限定符，DO NOTHING 操作，以及 RETURNING 子句是对SQLSQL 标准的一部分。