描述

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 權限。您還需要對 data_source 和任何 condition (包括 join_condition) 或 expression 中參考的目標表格的任何欄具有 SELECT 權限。權限會在陳述式開始時測試一次，無論是否執行特定的 WHEN 子句都會檢查。

如果目標表格是具體化檢視、外部表格，或者它有任何定義在其上的規則，則不支援 MERGE。

參數

輸出

成功完成時，MERGE 指令會回傳一個格式如下的指令標籤

MERGE total_count

total_count 是變更的總列數（無論是插入、更新或刪除）。如果 total_count 為 0，則沒有任何列以任何方式被變更。

如果 MERGE 指令包含 RETURNING 子句，則結果將類似於包含 RETURNING 清單中定義的欄位和值的 SELECT 陳述式，這些欄位和值是根據指令插入、更新或刪除的列計算得出的。

備註

在執行 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 的功能。這兩個陳述式類型之間存在各種差異和限制，並且它們不可互換。

範例

根據新的 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標準。