描述

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 標準的一部分。