Описание

MERGE выполняет действия, которые изменяют строки в целевой таблице, идентифицированной как target_table_name, используя data_source. MERGE предоставляет единую инструкцию SQL, которая может условно INSERT, UPDATE или DELETE строки, задачу, которая в противном случае потребовала бы нескольких операторов процедурного языка.

Во-первых, команда MERGE выполняет соединение из data_source с целевой таблицей, создавая ноль или более строк-кандидатов для изменения. Для каждой строки-кандидата для изменения статус MATCHED или NOT MATCHED устанавливается только один раз, после чего предложения WHEN оцениваются в указанном порядке. Для каждой строки-кандидата на внесение изменений выполняется первое предложение, которое оценивается как true. Не более одного предложения WHEN выполняется для любой строки-кандидата на внесение изменений.

Действия MERGE имеют тот же эффект, что и обычные команды UPDATE, INSERT или DELETE с теми же именами. Синтаксис этих команд отличается, в частности, отсутствием предложения WHERE и указания имени таблицы. Все действия относятся к целевой таблице, хотя изменения в других таблицах могут быть выполнены с использованием триггеров.

Когда указывается DO NOTHING, исходная строка пропускается. Поскольку действия оцениваются в указанном порядке, DO NOTHING может быть полезным для пропуска неинтересующих исходных строк перед более детальной обработкой.

Нет отдельной привилегии MERGE. Если вы указываете действие обновления, вы должны иметь привилегию UPDATE на столбец(ы) целевой таблицы, которые упоминаются в предложении SET. Если вы указываете действие вставки, вы должны иметь привилегию INSERT на целевую таблицу. Если вы указываете действие удаления, вы должны иметь привилегию DELETE на целевую таблицу. Если вы указываете действие DO NOTHING, вы должны иметь привилегию SELECT на как минимум один столбец целевой таблицы. Вам также потребуется привилегия SELECT на любой столбец(ы) data_source и целевой таблицы, упомянутые в любом condition (включая join_condition) или expression. Привилегии проверяются один раз при начале выполнения оператора и проверяются независимо от того, выполняются ли конкретные предложения WHEN или нет.

MERGE не поддерживается, если целевая таблица является материализованным представлением, внешней таблицей или если на ней определены какие-либо правила.

Параметры

Выводы

При успешном выполнении команды MERGE возвращается тег команды в следующем формате:

MERGE total_count

total_count - это общее количество измененных строк (вставленных, обновленных или удаленных). Если total_count равно 0, ни одна строка не была изменена.

Примечания

Следующие шаги выполняются во время выполнения MERGE.

Вкратце, триггеры операторов для типа события (скажем, INSERT) будут срабатывать каждый раз, когда мы указываем действие такого рода. В отличие от этого, триггеры на уровне строк будут срабатывать только для конкретного типа события, которое выполняется. Таким образом, команда MERGE может вызывать триггеры операторов как для UPDATE, так и для INSERT, даже если сработали только триггеры строк UPDATE.

Вы должны убедиться, что соединение производит не более одной строки изменений-кандидатов для каждой целевой строки. Другими словами, целевая строка не должна соединяться с более чем одной строкой источника данных. Если это происходит, то только одна из строк изменений-кандидатов будет использоваться для изменения целевой строки; попытки позже изменить строку вызовут ошибку. Это также может произойти, если триггеры строк вносят изменения в целевую таблицу, и затем эти измененные строки также изменяются с помощью MERGE. Если повторяемое действие - это INSERT, это вызовет нарушение уникальности, в то время как повторяющееся UPDATE или DELETE вызовет нарушение кардинальности; последнее поведение требуется стандартом SQL. Это отличается от исторического поведения Tantor BE в операторах UPDATE и DELETE, где вторые и последующие попытки изменить одну и ту же строку просто игнорируются.

Если подчиненное вложенное предложение AND не указано в предложении WHEN, оно становится последним достижимым предложением этого типа (MATCHED или NOT MATCHED). Если позднее указывается подпредложение WHEN этого типа, которое явно недостижимо, возникает ошибка. Если не указано ни одно достижимое вложенное предложение ни одного из типов, возможно, что никаких действий не будет предпринято для изменяемой строки-кандидата.

По умолчанию порядок генерации строк из источника данных неопределен. source_query может быть использован для указания последовательного порядка, если это необходимо, что может потребоваться для избежания блокировок между параллельными транзакциями.

В операторе MERGE отсутствует предложение RETURNING. Действия INSERT, UPDATE и DELETE не могут содержать предложения RETURNING или WITH.

Когда MERGE выполняется одновременно с другими командами, изменяющими целевую таблицу, применяются обычные правила изоляции транзакций; см. Раздел 13.2 для объяснения поведения на каждом уровне изоляции. Возможно, вам также стоит рассмотреть использование INSERT ... ON CONFLICT в качестве альтернативного оператора, который предлагает возможность выполнить UPDATE, если происходит одновременное INSERT. Существует ряд различий и ограничений между этими двумя типами операторов, и они не являются взаимозаменяемыми.

Примеры

Выполните обслуживание на таблице customer_accounts на основе новых recent_transactions.

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.