説明

MERGEは、data_sourceを使用して、target_table_nameの行を変更するアクションを実行します。 MERGEは、条件付きでINSERT、UPDATEまたはDELETE行を使用できる単一のSQL文を提供します。 この処理を行わないと、複数の手続き言語文が必要になります。

最初に、MERGEコマンドはdata_sourceからtarget_table_nameへの結合を実行し、0以上の候補変更行を生成します。 各候補変更行に対して、MATCHEDまたはNOT MATCHEDのステータスが一度だけ設定され、その後WHEN句が指定された順序で評価されます。 各候補変更行に対して、真と評価される最初の句が実行されます。 どの候補変更行に対しても、1つの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句が実行されたかどうかがチェックされます。 data_sourceおよびconditionで参照されるtarget_table_nameのすべての列に対してSELECT権限が必要です。

target_table_nameが実体化ビュー(Materialized View)、外部テーブルである場合、またはテーブルに規則が定義されている場合、MERGEはサポートされません。

パラメータ

出力

正常に完了すると、MERGEコマンドは以下の形式のコマンドタグを返します。

MERGE total_count

total_countは変更された行の合計数です(挿入、更新、または削除のいずれか)。 total_countが0の場合、行はまったく変更されていません。

注釈

次のステップは、MERGEの実行中に行われます。

要約するとイベントタイプの文トリガ（たとえば、INSERTなど）は、その種類のアクションを指定 するたびに起動されます。 対照的に、行レベルトリガは、実行される特定のイベントタイプに対してのみ起動されます。 したがって、MERGEコマンドでは、UPDATE行トリガのみが起動された場合でも、UPDATEとINSERTの両方に対して文トリガを起動する可能性があります。

結合では、各ターゲット行に対して最大1つの候補変更行が生成されるようにする必要があります。 つまり、ターゲット行は複数のデータソース行に結合できません。 結合する場合、候補変更行の1つだけがターゲット行の変更に使用されます。 後で行を変更しようとするとエラーが発生します。 これは、行トリガがターゲットテーブルを変更し、変更された行が後でMERGEによっても変更される場合にも発生する可能性があります。 繰り返されるアクションがINSERTの場合、一意性違反が発生しますが、UPDATEまたはDELETEを繰り返すとカーディナリティ違反が発生します。 後者の動作はSQL標準で要求されています。 これは、PostgreSQLのUPDATEおよびDELETE文における結合の歴史的な動作とは異なります。 この動作では、2回目以降の同じ行の変更は単純に無視されます。

WHEN句でAND副句が省略された場合、その句はその種類の最終到達可能句(MATCHEDまたはNOT MATCHED)になります。 その種類の後のWHEN句が指定された場合、到達不能である可能性があり、エラーが発生します。 いずれの種類の最終到達可能句も指定されていない場合、候補変更行に対してアクションが実行されない可能性があります。

デフォルトでは、データソースから行が生成される順序は不定です。 source_queryを使用して、必要に応じて一貫した順序を指定できます。 これは、コンカレント・トランザクション間のデッドロックを回避するために必要になる場合があります。

MERGEにはRETURNING句はありません。 INSERT、UPDATE、DELETEのアクションにRETURNING句やWITH句を含めることはできません。

MERGEをターゲットテーブルを変更する他のコマンドと同時に実行すると、通常のトランザクション分離ルールが適用されます。 各分離レベルでの動作の説明は13.2を参照してください。 また、INSERT ... ON CONFLICTを代替文として使用することも検討できます。 この文は、同時INSERTが発生した場合にUPDATEを実行する機能を提供します。 2つの文タイプの間には様々な違いや制限があり、相互に交換することはできません。

例

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

在庫数量とともに新規在庫品目を挿入しようとしました。 品目がすでに存在する場合は、既存品目の在庫数を更新します。 在庫数が0のエントリは許可しません。

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標準の拡張です。