説明

<command>MERGE</command> performs actions that modify rows in the <replaceable class="parameter">target_table_name</replaceable>, using the <replaceable class="parameter">data_source</replaceable>. <command>MERGE</command> provides a single <acronym>SQL</acronym> statement that can conditionally <command>INSERT</command>, <command>UPDATE</command> or <command>DELETE</command> rows, a task that would otherwise require multiple procedural language statements. MERGEは、data_sourceを使用して、target_table_nameの行を変更するアクションを実行します。 MERGEは、条件付きでINSERT、UPDATEまたはDELETE行を使用できる単一のSQL文を提供します。 この処理を行わないと、複数の手続き言語文が必要になります。

First, the <command>MERGE</command> command performs a join from <replaceable class="parameter">data_source</replaceable> to <replaceable class="parameter">target_table_name</replaceable> producing zero or more candidate change rows. For each candidate change row, the status of <literal>MATCHED</literal> or <literal>NOT MATCHED</literal> is set just once, after which <literal>WHEN</literal> clauses are evaluated in the order specified. For each candidate change row, the first clause to evaluate as true is executed. No more than one <literal>WHEN</literal> clause is executed for any candidate change row. 最初に、MERGEコマンドはdata_sourceからtarget_table_nameへの結合を実行し、0以上の候補変更行を生成します。 各候補変更行に対して、MATCHEDまたはNOT MATCHEDのステータスが一度だけ設定され、その後WHEN句が指定された順序で評価されます。 各候補変更行に対して、真と評価される最初の句が実行されます。 どの候補変更行に対しても、1つのWHEN句しか実行されません。

<command>MERGE</command> actions have the same effect as regular <command>UPDATE</command>, <command>INSERT</command>, or <command>DELETE</command> commands of the same names. The syntax of those commands is different, notably that there is no <literal>WHERE</literal> clause and no table name is specified. All actions refer to the <replaceable class="parameter">target_table_name</replaceable>, though modifications to other tables may be made using triggers. MERGEアクションは、同じ名前の通常のUPDATE、INSERTまたはDELETEコマンドと同じ効果を持ちます。 これらのコマンドの構文は異なり、WHERE句がなく、テーブル名が指定されていません。 すべてのアクションはtarget_table_nameを参照しますが、他のテーブルへの変更はトリガを使用して行うことができます。

When <literal>DO NOTHING</literal> is specified, the source row is skipped. Since actions are evaluated in their specified order, <literal>DO NOTHING</literal> can be handy to skip non-interesting source rows before more fine-grained handling. DO NOTHINGが指定されている場合、ソース行はスキップされます。 アクションは指定された順序で評価されるため、DO NOTHINGは、より詳細な処理の前に、関心のないソース行をスキップする場合に便利です。

There is no separate <literal>MERGE</literal> privilege. If you specify an update action, you must have the <literal>UPDATE</literal> privilege on the column(s) of the <replaceable class="parameter">target_table_name</replaceable> that are referred to in the <literal>SET</literal> clause. If you specify an insert action, you must have the <literal>INSERT</literal> privilege on the <replaceable class="parameter">target_table_name</replaceable>. If you specify an delete action, you must have the <literal>DELETE</literal> privilege on the <replaceable class="parameter">target_table_name</replaceable>. Privileges are tested once at statement start and are checked whether or not particular <literal>WHEN</literal> clauses are executed. You will require the <literal>SELECT</literal> privilege on the <replaceable class="parameter">data_source</replaceable> and any column(s) of the <replaceable class="parameter">target_table_name</replaceable> referred to in a <literal>condition</literal>. 個別のMERGE権限はありません。 更新アクションを指定する場合は、SET句で参照されるtarget_table_nameの列に対してUPDATE権限を持っている必要があります。 挿入アクションを指定する場合は、target_table_nameに対してINSERT権限を持っている必要があります。 削除アクションを指定する場合は、target_table_nameに対してDELETE権限を持っている必要があります。 権限は文の開始時に一度テストされ、特定のWHEN句が実行されたかどうかがチェックされます。 data_sourceおよびconditionで参照されるtarget_table_nameのすべての列に対してSELECT権限が必要です。

<command>MERGE</command> is not supported if the <replaceable class="parameter">target_table_name</replaceable> is a materialized view, foreign table, or if it has any rules defined on it. target_table_nameが実体化ビュー(Materialized View)、外部テーブルである場合、またはテーブルに規則が定義されている場合、MERGEはサポートされません。

パラメータ

出力

On successful completion, a <command>MERGE</command> command returns a command tag of the form 正常に完了すると、MERGEコマンドは以下の形式のコマンドタグを返します。

MERGE total_count

The <replaceable class="parameter">total_count</replaceable> is the total number of rows changed (whether inserted, updated, or deleted). If <replaceable class="parameter">total_count</replaceable> is 0, no rows were changed in any way. total_countは変更された行の合計数です(挿入、更新、または削除のいずれか)。 total_countが0の場合、行はまったく変更されていません。

注釈

The following steps take place during the execution of <command>MERGE</command>. 次のステップは、MERGEの実行中に行われます。

In summary, statement triggers for an event type (say, <command>INSERT</command>) will be fired whenever we <emphasis>specify</emphasis> an action of that kind. In contrast, row-level triggers will fire only for the specific event type being <emphasis>executed</emphasis>. So a <command>MERGE</command> command might fire statement triggers for both <command>UPDATE</command> and <command>INSERT</command>, even though only <command>UPDATE</command> row triggers were fired. 要約するとイベントタイプの文トリガ（たとえば、INSERTなど）は、その種類のアクションを指定 するたびに起動されます。 対照的に、行レベルトリガは、実行される特定のイベントタイプに対してのみ起動されます。 したがって、MERGEコマンドでは、UPDATE行トリガのみが起動された場合でも、UPDATEとINSERTの両方に対して文トリガを起動する可能性があります。

You should ensure that the join produces at most one candidate change row for each target row. In other words, a target row shouldn't join to more than one data source row. If it does, then only one of the candidate change rows will be used to modify the target row; later attempts to modify the row will cause an error. This can also occur if row triggers make changes to the target table and the rows so modified are then subsequently also modified by <command>MERGE</command>. If the repeated action is an <command>INSERT</command>, this will cause a uniqueness violation, while a repeated <command>UPDATE</command> or <command>DELETE</command> will cause a cardinality violation; the latter behavior is required by the <acronym>SQL</acronym> standard. This differs from historical <productname>PostgreSQL</productname> behavior of joins in <command>UPDATE</command> and <command>DELETE</command> statements where second and subsequent attempts to modify the same row are simply ignored. 結合では、各ターゲット行に対して最大1つの候補変更行が生成されるようにする必要があります。 つまり、ターゲット行は複数のデータソース行に結合できません。 結合する場合、候補変更行の1つだけがターゲット行の変更に使用されます。 後で行を変更しようとするとエラーが発生します。 これは、行トリガがターゲットテーブルを変更し、変更された行が後でMERGEによっても変更される場合にも発生する可能性があります。 繰り返されるアクションがINSERTの場合、一意性違反が発生しますが、UPDATEまたはDELETEを繰り返すとカーディナリティ違反が発生します。 後者の動作はSQL標準で要求されています。 これは、PostgreSQLのUPDATEおよびDELETE文における結合の歴史的な動作とは異なります。 この動作では、2回目以降の同じ行の変更は単純に無視されます。

If a <literal>WHEN</literal> clause omits an <literal>AND</literal> sub-clause, it becomes the final reachable clause of that kind (<literal>MATCHED</literal> or <literal>NOT MATCHED</literal>). If a later <literal>WHEN</literal> clause of that kind is specified it would be provably unreachable and an error is raised. If no final reachable clause is specified of either kind, it is possible that no action will be taken for a candidate change row. WHEN句でAND副句が省略された場合、その句はその種類の最終到達可能句(MATCHEDまたはNOT MATCHED)になります。 その種類の後のWHEN句が指定された場合、到達不能である可能性があり、エラーが発生します。 いずれの種類の最終到達可能句も指定されていない場合、候補変更行に対してアクションが実行されない可能性があります。

The order in which rows are generated from the data source is indeterminate by default. A <replaceable class="parameter">source_query</replaceable> can be used to specify a consistent ordering, if required, which might be needed to avoid deadlocks between concurrent transactions. デフォルトでは、データソースから行が生成される順序は不定です。 source_queryを使用して、必要に応じて一貫した順序を指定できます。 これは、コンカレント・トランザクション間のデッドロックを回避するために必要になる場合があります。

There is no <literal>RETURNING</literal> clause with <command>MERGE</command>. Actions of <command>INSERT</command>, <command>UPDATE</command> and <command>DELETE</command> cannot contain <literal>RETURNING</literal> or <literal>WITH</literal> clauses. MERGEにはRETURNING句はありません。 INSERT、UPDATE、DELETEのアクションにRETURNING句やWITH句を含めることはできません。

When <command>MERGE</command> is run concurrently with other commands that modify the target table, the usual transaction isolation rules apply; see <xref linkend="transaction-iso"/> for an explanation on the behavior at each isolation level. You may also wish to consider using <command>INSERT ... ON CONFLICT</command> as an alternative statement which offers the ability to run an <command>UPDATE</command> if a concurrent <command>INSERT</command> occurs. There are a variety of differences and restrictions between the two statement types and they are not interchangeable. MERGEをターゲットテーブルを変更する他のコマンドと同時に実行すると、通常のトランザクション分離ルールが適用されます。 各分離レベルでの動作の説明は13.2を参照してください。 また、INSERT ... ON CONFLICTを代替文として使用することも検討できます。 この文は、同時INSERTが発生した場合にUPDATEを実行する機能を提供します。 2つの文タイプの間には様々な違いや制限があり、相互に交換することはできません。

例

Perform maintenance on <literal>customer_accounts</literal> based upon new <literal>recent_transactions</literal>. 新規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);

Notice that this would be exactly equivalent to the following statement because the <literal>MATCHED</literal> result does not change during execution. 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);

Attempt to insert a new stock item along with the quantity of stock. If the item already exists, instead update the stock count of the existing item. Don't allow entries that have zero stock. 在庫数量とともに新規在庫品目を挿入しようとしました。 品目がすでに存在する場合は、既存品目の在庫数を更新します。 在庫数が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;

The <literal>wine_stock_changes</literal> table might be, for example, a temporary table recently loaded into the database. wine_stock_changesテーブルは、たとえば、最近データベースにロードされた一時テーブルです。

互換性

This command conforms to the <acronym>SQL</acronym> standard. このコマンドは、SQL標準に準拠しています。

The WITH clause and <literal>DO NOTHING</literal> action are extensions to the <acronym>SQL</acronym> standard. WITH句とDO NOTHINGアクションは、SQL標準の拡張です。