[ WITH with_query [, ...] ]
MERGE INTO [ ONLY ] target_table_name [ * ] [ [ AS ] target_alias ]
USING data_source ON join_condition
when_clause [...]

where data_source is:

{ [ ONLY ] source_table_name [ * ] | ( source_query ) } [ [ AS ] source_alias ]

and when_clause is:

{ WHEN MATCHED [ AND condition ] THEN { merge_update | merge_delete | DO NOTHING } |
  WHEN NOT MATCHED [ AND condition ] THEN { merge_insert | DO NOTHING } }

and merge_insert is:

INSERT [( column_name [, ...] )]
[ OVERRIDING { SYSTEM | USER } VALUE ]
{ VALUES ( { expression | DEFAULT } [, ...] ) | DEFAULT VALUES }

and merge_update is:

UPDATE SET { column_name = { expression | DEFAULT } |
             ( column_name [, ...] ) = ( { expression | DEFAULT } [, ...] ) } [, ...]

and merge_delete is:

DELETE

说明

MERGE 执行操作来修改 target_table_name 中的行，使用 data_source。 MERGE 提供了一个 SQL 语句，该语句可以有条件地 INSERT、UPDATE 或 DELETE 行，而此任务通常需要多个过程语言语句。

首先，MERGE 命令从 data_source 到 target_table_name 执行联接，生成零个或多个候选更改行。对于每个候选更改行，MATCHED 或 NOT MATCHED 状态只设置一次，之后 WHEN 子句按指定的顺序进行评估。对于每个候选更改行，第一个评估为 true 的子句将被执行。对于任何候选更改行，最多只执行一个 WHEN 子句。

MERGE 操作与同名常规 UPDATE、INSERT 或 DELETE 命令具有相同的效果。这些命令的语法不同，特别是没有 WHERE 子句，并且没有指定表名。所有操作都引用 target_table_name，尽管可以使用触发器对其他表进行修改。

当指定 DO NOTHING 时，将跳过源行。由于按指定顺序评估操作，DO NOTHING 可用于在进行更细粒度的处理之前跳过无意义的源行。

没有单独的 MERGE 权限。如果您指定更新操作，则必须对 SET 子句中引用的 target_table_name 的列具有 UPDATE 权限。如果您指定插入操作，则必须对 target_table_name 具有 INSERT 权限。如果您指定删除操作，则必须对 target_table_name 具有 DELETE 权限。权限在语句开始时测试一次，并且无论是否执行特定 WHEN 子句而进行检查。您将需要对任何 condition 或 expression 中引用的 data_source 和 target_table_name 的任何列具有 SELECT 权限。

如果 target_table_name 是物化视图、外部表，或已对其定义任何规则，则不支持 MERGE。

参数

输出

成功完成后，MERGE 命令将返回以下形式的命令标记

MERGE total_count

total_count 是更改的总行数（无论插入、更新还是删除）。如果 total_count 为 0，则未以任何方式更改任何行。

备注

在执行 MERGE 期间，将执行以下步骤。

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

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

如果 WHEN 子句省略 AND 子句，它将成为该类型的最终可达子句（MATCHED 或 NOT MATCHED）。如果指定了该类型的后续 WHEN 子句，则它将被证明不可达，并且会引发错误。如果没有指定任何类型的最终可达子句，则候选更改行可能不会执行任何操作。

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

MERGE 没有 RETURNING 子句。INSERT、UPDATE 和 DELETE 操作不能包含 RETURNING 或 WITH 子句。

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

例如，wine_stock_changes 表可能是最近加载到数据库中的临时表。

兼容性

此命令符合 SQL 标准。

WITH 子句和 DO NOTHING 操作是对 SQL 标准的扩展。