affectation
Fusionner les enregistrements source dans la table cible (ou la vue actualisable).
Syntaxe
MERGE
INTO target [[AS] target_alias]
USING <source> [[AS] source_alias]
ON <join condition>
<merge when> [<merge when> ...]
[<plan clause>]
[<order by clause>]
[<returning clause>]
<source> ::= tablename | (<select_stmt>)
<merge when> ::=
<merge when matched>
| <merge when not matched by target>
| <merge when not matched by source>
<merge when matched> ::=
WHEN MATCHED [ AND <condition> ]
THEN { UPDATE SET <assignment_list> | DELETE }
<merge when not matched by target> ::=
WHEN NOT MATCHED [ BY TARGET ] [ AND <condition> ]
THEN INSERT [ <left paren> <column_list> <right paren> ]
VALUES <left paren> <value_list> <right paren>
<merge when not matched by source> ::=
WHEN NOT MATCHED BY SOURCE [ AND <condition> ] THEN
{ UPDATE SET <assignment list> | DELETE }
<assignment_list> ::=
col_name = <m_value> [, colname = <m_value> ...]
<column_list> ::= col_name [, col_name ...]
<value_list> ::= <m_value> [, <m_value> ...]
<m_value> ::= <value_expression> | DEFAULT
<returning clause> ::= RETURNING <returning_list> [INTO <variable_list>]
<returning_list> ::= * | <output_column> [, <output_column]
<output_column> ::=
target.* | NEW.* | OLD.*
| <return_expression> [COLLATE collation] [[AS] ret_alias]
<return_expression> ::=
<value_expression>
| [target.]col_name
| NEW.col_name
| OLD.col_name
<value_expression> ::=
<literal>
| <context-variable>
| <other-single-value-expr>
<variables> ::=
[:]varname [, [:]varname ...]
Table 1. Paramètres de l’opérateur MERGE
Paramètre |
Description |
target |
La table ou la vue actualisable cible. |
source |
Source de données : peut être une table, une vue, une procédure stockée ou une table dérivée. |
target_alias |
L’alias de la table ou de la vue cible. |
source_alias |
Alias de la source. |
join condition |
Une condition pour connecter la table cible et la source. |
condition |
Conditions de contrôle supplémentaires dans les clauses WHEN MATCHED ou WHEN NOT MATCHED . |
col_name |
La colonne de la table ou de la vue cible. |
m_value |
Une valeur assignée à une colonne dans la table cible. Une expression qui peut contenir des littéraux, des variables PSQL, des colonnes d’une source. |
return_expression |
Expression renvoyée dans une clause RETURNING . |
ret_alias |
Alias pour l’expression retournée dans la clause RETURNING . |
varname |
Le nom de la variable PSQL. |
L’instruction MERGE
fusionne les enregistrements de la table source et de la table cible (ou une vue actualisable).Lors de l’exécution de l’instruction MERGE
, les enregistrements sources sont lus et INSERT, UPDATE ou DELETE sont exécutés pour la cible.en fonction des conditions.
La source peut être une table, une vue, une procédure stockée ou une table dérivée. Lorsque l’instruction MERGE
est exécuté, une connexion est établie entre la table source (USING) et la table cible. Le type de connexion dépend de la présence de clauses WHEN NOT MATCHED
:
-
<merge when not matched by target> and <merge when not matched by source> — FULL JOIN
-
<fusionner quand la source ne correspond pas> — JOINT DROIT
-
<merge quand il n’y a pas de correspondance avec la cible> — LEFT JOIN
-
seulement <fusionner en cas de correspondance> — INNER JOIN
L’action sur la table cible et la condition dans laquelle elle se produit sont décrites dans la clause WHEN
. Les clauses multiples WHEN MATCHED
, WHEN NOT MATCHED [BY TARGET]
et WHEN NOT MATCHED BY SOURCE
sont autorisées.
Si la condition de la clause WHEN
n’est pas remplie, Firebird la saute et passe à la clause suivante. Cela se produira jusqu’à ce que la condition de l’une des clauses WHEN
ne soit pas satisfaite. Dans ce cas, l’action associée à la clause WHEN
est exécutée et l’enregistrement suivant du résultat de la connexion entre la table source (USING) et la table cible est ignoré. Une seule action est effectuée pour chaque enregistrement de résultat de connexion.
Note
|
La clause WHEN NOT MATCHED [BY TARGET] est évaluée en fonction de la source, c’est-à-dire la table ou le jeu de données spécifié dans la clause USING . En effet, si l’enregistrement source ne correspond pas à l’enregistrement cible, la clause INSERT est exécutée. Bien entendu, si l’enregistrement cible ne correspond pas à l’enregistrement source, aucune action n’est effectuée.
Actuellement, la variable ROW_COUNT renvoie 1, même si plus d’un enregistrement a été modifié ou inséré. CORE-4400.
|