Définitions
Variables
Une variable est un composant commun qui agit comme un espace réservé pour représenter des valeurs susceptibles d'être modifiées chaque fois qu'un job est exécuté. Pour faciliter l'identification des variables dans une expression, les noms de variables commencent par un signe dollar ($). Ils peuvent être de n'importe quel type de données pris en charge par Data Services.
Une variable peut être globale ou locale.
- Variables globales
- Définir au niveau du job
- Disponible pour l'affectation ou la référence dans les objets subordonnés
- Peut être affecté dans les propriétés de job et/ou d'exécution
- Variables locales
- Variable liée à l'objet
- Non disponible directement dans les objets référencés
- Peut uniquement être affecté via des scripts.
Paramètres
Un paramètre est un autre type de caractère générique qui appelle une variable.
Cet appel permet de transférer la valeur de la variable dans un job ou un workflow au paramètre dans un workflow ou un flux de données dépendant. Les paramètres sont généralement utilisés pour filtrer les données dans les clauses WHERE.
- Paramètres
- Peut être une entrée ou une sortie, à sens unique ou bidirectionnel
- Affecté dans l'onglet Appels de Variables et paramètres
- Appelle une variable
Attribution de noms aux variables et aux paramètres
Convention d'appellation
Commencez tous les noms par le symbole dollar ($) et utilisez les préfixes de la table comme convention d'appellation pour garantir la cohérence entre les projets :
| Type | Convention d'appellation |
|---|---|
| Variable globale | $G_ |
| Variable locale | $L_ |
| Paramètre | $P_ |
Variables globales par rapport aux variables et paramètres locaux
Les variables locales sont limitées au job ou au workflow dans lequel elles sont créées. Vous pouvez uniquement affecter une variable locale via un script. Vous pouvez utiliser des paramètres pour transférer des variables locales aux workflows et aux flux de données dans l'objet. Une variable locale est incluse dans la définition du workflow ou du flux de données et est donc portable entre les jobs.
Les variables globales sont également limitées au job dans lequel elles sont créées. Leur valeur peut être affectée via un script ou lors de l'exécution. Ils ne nécessitent pas le transfert de paramètres aux workflows et aux flux de données dans ce job. Vous pouvez référencer la variable globale directement dans les expressions pour n'importe quel objet du job.
Attention
Les variables globales peuvent simplifier votre travail. Définissez des valeurs pour les variables globales dans les objets de script ou à l'aide de l'exécution de job externe ou des propriétés de planification. Par exemple, pendant la production, vous pouvez modifier les valeurs des variables globales par défaut au moment de l'exécution à partir de la planification d'un job sans avoir à ouvrir un job dans Designer.
Variables et paramètres par type d'objet
Le tableau récapitule les variables et les paramètres que vous pouvez créer pour chaque type d'objet :
| Objet | Type | Utilisé par |
|---|---|---|
| Job | Variable globale | N'importe quel objet dans le job. |
| Job | Variable locale | Script ou structure conditionnelle dans le job. |
| Workflow | Variable locale | Ce workflow ou transmis à d'autres workflows ou flux de données à l'aide d'un paramètre. |
| Workflow | Paramètre | Objets parents pour transférer les variables. Les workflows peuvent également renvoyer des variables ou des paramètres aux objets parents. |
| Flux de données | Paramètre | Clause WHERE, mappage de colonne ou fonction dans le flux de données. Les flux de données ne peuvent pas renvoyer de valeurs de sortie. |
Définition de la valeur par défaut des variables globales
Outre la définition d'une variable dans un job à l'aide d'un script, vous pouvez définir et gérer des valeurs de variables globales par défaut à l'aide des propriétés du job.
Les valeurs définies dans les propriétés du job sont traitées de la même manière que celles définies dans un script. Si vous définissez une valeur pour la même variable à la fois dans un script et dans les propriétés du job, la valeur du script remplace la valeur de la propriété.
Toutes les valeurs définies comme propriétés de tâche sont affichées dans la fenêtre Propriétés. En définissant des valeurs en dehors d'un script, vous pouvez vous baser sur la fenêtre Propriétés pour afficher les valeurs qui ont été définies pour les variables globales et modifier facilement les valeurs lors du test ou de la planification d'un job.
Définition de variables globales à l'aide des propriétés d'exécution
Vous pouvez également afficher et modifier ces valeurs par défaut dans la boîte de dialogue Propriétés d'exécution du Designer. Cela vous permet de remplacer les valeurs de propriété du job au moment de l'exécution. Data Services enregistre les valeurs dans le référentiel en tant que propriétés du job.