Exists - fonction de script
Exists() détermine si une valeur de champ donnée a déjà été chargée dans le champ du script de chargement de données. La fonction renvoie TRUE ou FALSE. Elle peut donc être utilisée dans la clause where d'une instruction LOAD ou d'une instruction IF.
Exists(field_name [, expr])
booléen
Argument | Description |
---|---|
field_name |
Nom du champ dans lequel vous souhaitez rechercher une valeur. Vous pouvez utiliser un nom de champ explicite sans guillemets. Le champ doit déjà être chargé par le script. Autrement dit, vous ne pouvez pas faire référence à un champ qui est chargé dans une clause située plus loin dans le script. |
expr |
Valeur dont vous souhaitez vérifier l'existence. Vous pouvez utiliser une valeur explicite ou une expression qui fait référence à un ou plusieurs champs situés dans l'instruction de chargement. Note InformationsIl n'est pas possible de faire référence à des champs non inclus dans l'instruction de chargement active.
Cet argument est facultatif. Si vous l'omettez, la fonction vérifiera si la valeur de field_name figurant dans l'enregistrement actif existe déjà. |
Données utilisées dans l'exemple :
Exists (Employee)
Renvoie -1 (True) si la valeur du champ Employee figurant dans l'enregistrement actif existe déjà dans un enregistrement lu précédemment et contenant ce champ.
Les instructions Exists (Employee, Employee) et Exists (Employee) sont équivalentes.
Exists(Employee, 'Bill')
Renvoie -1 (True) si la valeur de champ 'Bill' se trouve dans le contenu actif du champ Employee.
Vous obtenez une table que vous pouvez utiliser dans une visualisation de table à l'aide des dimensions Employee et Address.
La clause where where Exists (Employee) signifie que seuls les noms issus de la table Citizens et figurant également dans Employees sont chargés dans la nouvelle table. Pour éviter toute confusion, l'instruction Drop supprime la table Employees.
Employee | Address |
Bill | New York |
John | Miami |
Steve | Chicago |
La clause where inclut not : where not Exists (Employee, Name).
Autrement dit, seuls les noms issus de la table Citizens qui ne figurent pas dans Employees sont chargés dans la nouvelle table.
Notez la présence de deux valeurs pour Lucy dans la table Citizens, mais une seule figure dans la table des résultats. Lorsque vous chargez la première ligne, la valeur est incluse dans la table des symboles Employee. De ce fait, lorsque la deuxième ligne est vérifiée, la valeur existe à présent.
L'exemple suivant explique comment charger toutes les valeurs.
Employee | Address |
---|---|
Mary | London |
Lucy | Madrid |
Pour obtenir toutes les valeurs associées à Lucy, modifiez deux éléments :
-
Ajoutez une instruction Load antérieure à Employees dans laquelle vous renommez Employee en Name.
Load Employee As Name, ID, Salary;
-
Remplacez la condition Where dans Citizens par :
not Exists (Name, Employee).
Vous obtiendrez alors des tables de symboles différentes pour Name et Employee. Lorsque la deuxième ligne relative à Lucy est vérifiée, elle n'existe toujours pas dans Name.
Employee | Address |
---|---|
Mary | London |
Lucy | Madrid |
Lucy | Paris |