9.23. Função de suporte à mesclagem #

O PostgreSQL inclui uma função de suporte para mesclagem que pode ser usada na lista RETURNING do comando MERGE para identificar a ação tomada para cada linha; veja a Tabela 9.68.

Tabela 9.68. Função de suporte à mesclagem

Função

Descrição

merge_action ( ) → text

Retorna o comando da ação de mesclagem executado para a linha corrente. Será 'INSERT', 'UPDATE' ou 'DELETE'.


Exemplo 9.9. Ação de mesclagem

MERGE INTO products p
  USING stock s ON p.product_id = s.product_id
  WHEN MATCHED AND s.quantity > 0 THEN
    UPDATE SET in_stock = true, quantity = s.quantity
  WHEN MATCHED THEN
    UPDATE SET in_stock = false, quantity = 0
  WHEN NOT MATCHED THEN
    INSERT (product_id, in_stock, quantity)
      VALUES (s.product_id, true, s.quantity)
  RETURNING merge_action(), p.*;

 merge_action | product_id | in_stock | quantity
--------------+------------+----------+----------
 UPDATE       |       1001 | t        |       50
 UPDATE       |       1002 | f        |        0
 INSERT       |       1003 | t        |       10


Note que esta função só pode ser usada na lista RETURNING do comando MERGE. É um erro usá-la em qualquer outra parte da consulta.