Merge

Le préfixe Merge peut être ajouté à n'importe quelle instruction LOAD ou SELECT du script pour spécifier que la table chargée doit être fusionnée dans une autre table. Cela spécifie également que cette instruction doit être exécutée lors d'un chargement partiel.

Un cas d'utilisation type se produit, par exemple, lorsque vous chargez un journal des modifications et que vous souhaitez l'utiliser pour appliquer inserts, updates et deletes à une table existante.

Effectuez un chargement partiel via le bouton Charger. Pour plus d'informations, voir Bouton. Vous pouvez également utiliser Qlik Engine JSON API.

Merge [only] [(SequenceNoField [, SequenceNoVar])] On ListOfKeys [Concatenate [(TableName)]] (loadstatement | selectstatement)

Fonctionnalité générale

Lors d'un chargement normal (non partiel), la construction Merge LOAD fonctionne comme une instruction Load normale, mais avec la fonctionnalité supplémentaire consistant à supprimer les enregistrements obsolètes plus anciens et les enregistrements indiqués comme devant être supprimés. Le premier champ de l'instruction Load doit contenir des informations sur l'opération : Insert, Update ou Delete.

Pour chaque enregistrement chargé, l'identificateur d'enregistrement est comparé aux enregistrements précédemment chargés et seul le dernier enregistrement (en fonction du numéro de séquence) est conservé. Si le dernier enregistrement est marqué à l'aide de Delete, aucun n'est conservé.

Table cible

La table à modifier est déterminée par l'ensemble de champs. Si une table avec le même ensemble de champs (sauf le premier champ ; l'opération) existe déjà, il s'agira de la table à modifier. Sinon, un préfixe Concatenate peut être utilisé pour spécifier la table. Si la table cible n'est pas déterminée, le résultat de la construction Merge LOAD est stocké dans une nouvelle table.

Si le préfixe Concatenate est utilisé, la table obtenue comprend un ensemble de champs correspondant à l'union de la table existante et de l'entrée de la fusion. Ainsi, la table cible peut recevoir plus de champs que le journal des modifications utilisé comme entrée de la fusion.

Un chargement partiel a le même résultat qu'un chargement complet. La différence réside dans le fait qu'un chargement partiel crée rarement une nouvelle table. À moins d'avoir utilisé la clause Only, il existe toujours une table cible avec le même ensemble de champs que l'exécution de script précédente.

Nombre de séquences

Si le journal des modifications chargé est un journal accumulé, à savoir, s'il contient des modifications déjà chargées, il est possible d'utiliser le paramètre SequenceNoVar dans une clause Where pour limiter le nombre de données d'entrée. La construction Merge LOAD peut alors s'appliquer uniquement aux enregistrements à charger dont le champ SequenceNoField est supérieur à SequenceNoVar. Une fois terminée, la construction Merge LOAD assigne une nouvelle valeur à SequenceNoVar avec la valeur maximale trouvée dans le champ SequenceNoField.

Opérations

La construction Merge LOAD peut contenir moins de champs que la table cible. Les différentes opérations traitent les champs manquants différemment :

Insert : Les champs manquants dans la construction Merge LOAD, mais existants dans la table cible, reçoivent une valeur NULL dans la table cible.

Delete : Les champs manquants n'affectent pas le résultat. Les enregistrements pertinents sont de toute façon supprimés.

Update : Les champs figurant dans Merge LOAD sont mis à jour dans la table cible. Les champs manquants ne sont pas modifiés. Cela signifie que les deux instructions suivantes ne sont pas identiques :

• Merge on Key Concatenate Load 'U' as Operation, Key, F1, Null() as F2 From ...;
• Merge on Key Concatenate Load 'U' as Operation, Key, F1 From ...;

La première instruction met à jour les enregistrements répertoriés et remplace F2 par NULL. La deuxième instruction ne remplace pas F2, mais laisse les valeurs dans la table cible.

Set DateFormat='D/M/YYYY';
Persons:
load * inline [
Name, Number
Jake, 3
Jill, 2
Steven, 3
];

Merge (ChangeDate, LastChangeDate) on Name Concatenate(Persons)
LOAD * inline [
Operation, ChangeDate,   Name,     Number
Insert,    1/1/2021,     Mary,     4
Delete,    1/1/2021,     Steven, 
Update,    2/1/2021,     Jake,     5
];

Set DateFormat='D/M/YYYY';
Persons:
Load * Inline [
PersonID, Name, Number
1, Jake, 3
2, Jill, 2
3, Steven, 3
];

Merge (ChangeDate, LastChangeDate) on PersonID Concatenate(Persons)
Load * Inline [
Operation, ChangeDate,   PersonID, Name,     Number
Insert,    1/1/2021,     4,        Mary,     4
Delete,    1/1/2021,     3,        Steven, 
];

Merge (ChangeDate, LastChangeDate) on PersonID Concatenate(Persons)
Load * Inline [
Operation, ChangeDate,   PersonID, Number
Update,    2/1/2021,     1,        5
Update,    3/1/2021,     2,        6
];

Merge Only (ChangeDate, LastChangeDate) on Name Concatenate(Persons)
LOAD Operation, ChangeDate,  Name, Number 
from [lib://ChangeFilesFolder/BulkChangesInPersonsTable.csv] (txt)
where ChangeDate >= $(LastChangeDate);