Fenêtre Variables

  • Article

S’applique à :SQL Server SSIS Integration Runtime dans Azure Data Factory

La fenêtre Variables permet de créer et de modifier les variables définies par l’utilisateur et d’afficher les variables système.

Par défaut, la fenêtre Variables se trouve sous la zone Gestionnaires de connexions du concepteur SSIS, dans SQL Server Data Tools (SSDT). Si vous ne voyez pas la fenêtre Variables, cliquez sur Variables dans le menu SSIS pour l’afficher.

Vous pouvez éventuellement afficher la fenêtre Variables en mappant la commande View.Variables avec une combinaison de clés de votre choix dans la page Clavier de la boîte de dialogue Options .

Notes

La valeur des propriétés Nom et Espace de noms doit commencer par une lettre de l’alphabet, conformément à la convention Unicode Standard 2.0, ou par un trait de soulignement (_). Les caractères suivants peuvent être des lettres ou des nombres, conformément à la convention Unicode standard 2.0, ou un trait de soulignement (_).

Options

Ajouter une variable
Ajoutez une variable définie par l'utilisateur.

Déplacer la variable
Cliquez sur une variable dans la liste, puis cliquez sur Déplacer la variable pour modifier l’étendue de la variable. Dans la boîte de dialogue Sélectionner une nouvelle étendue , sélectionnez le package ou un conteneur, une tâche ou un gestionnaire d'événements dans le package pour modifier l'étendue de la variable.

Pour plus d’informations sur la portée des variables, consultez Variables Integration Services (SSIS).

Supprimer une variable
Sélectionnez une variable dans la liste, puis cliquez sur Supprimer une variable.

Options de la grille
Cliquez sur cette option pour ouvrir la boîte de dialogue Options de grille variables où vous pouvez modifier la sélection des colonnes et appliquer des filtres à la fenêtre Variables . Pour plus d'informations, consultez Options de grille variables.

Nom
Affichez le nom de la variable. Vous pouvez mettre à jour le nom des variables définies par l'utilisateur.

Étendue
Affichez l'étendue de la variable. Une variable a l'étendue du package entier ou celle d'un conteneur ou d'une tâche. L'étendue de la variable doit être suffisante pour qu'elle soit visible pour tout autre composant ou tâche qui doit lire ou définir ses valeurs.

Vous pouvez modifier l'étendue en cliquant sur la variable puis en cliquant sur Déplacer la variable dans la fenêtre Variables .

Type de données
Affichez le type de données de la variable. Vous pouvez sélectionner le type de données dans la liste des variables définies par l'utilisateur.

Notes

Si vous affectez une expression à la variable, vous ne pouvez pas modifier le type de données.

Valeur
Affichez la valeur de la variable. Vous pouvez mettre à jour la valeur des variables définies par l'utilisateur. Cette valeur peut être un littéral ou une expression. En outre, la valeur peut être une chaîne multiligne. Pour affecter une expression à la variable, cliquez sur le bouton d'ellipse qui est en regard de la colonne Expression dans la fenêtre Variables .

Espace de noms
Affichez le nom de l'espace de noms. Les variables définies par l’utilisateur sont initialement créées dans l’espace de noms User , mais vous pouvez modifier le nom de celui-ci dans le champ Espace de noms . Pour afficher cette colonne, cliquez sur Options de la grille.

Déclencher l'événement lorsque la valeur de la variable change
Indiquez si l’événement OnVariableValueChanged doit se déclencher quand une valeur est modifiée. Vous pouvez mettre à jour la valeur des variables système définies par l'utilisateur. Par défaut, la fenêtre Variables ne répertorie pas cette colonne. Pour afficher cette colonne, cliquez sur Options de la grille.

Description
Affichez la description de la variable. Vous pouvez modifier la description des variables définies par l'utilisateur. Par défaut, la fenêtre Variables ne répertorie pas cette colonne. Pour afficher cette colonne, cliquez sur Options de la grille.

Expression
Affichez l'expression affectée à la variable. Pour affecter une expression, cliquez sur le bouton d'ellipse.

Si vous affectez une expression à une variable, un marqueur spécial sous la forme d'une icône s'affiche en regard de la variable. Ce marqueur d'icône spécial s'affiche également en regard des gestionnaires de connexions et des tâches contenant des expressions.

Options de grille variable, boîte de dialogue

Utilisez la boîte de dialogue Options de grille variables pour sélectionner les colonnes qui s'affichent dans la fenêtre Variables et sélectionner les filtres à appliquer à la liste des variables. Pour plus d'informations sur les propriétés de variable correspondantes, consultez Variables Integration Services (SSIS).

Options pour le filtre

Afficher les variables système
Sélectionnez cette option pour répertorier les variables système dans la fenêtre Variables . Les variables système sont prédéfinies. Vous ne pouvez pas ajouter ou supprimer des variables système. Vous pouvez modifier le paramètre de la propriété RaiseChangedEvent .

Cette liste est codée par couleur. Les variables système sont en gris et les variables définies par l'utilisateur en noir.

Afficher les variables de toutes les étendues
Sélectionnez cette option pour afficher les variables dans l'étendue du package et dans l'étendue des conteneurs, des tâches et des gestionnaires d'événements dans le package. Désactivez cette option pour afficher uniquement les variables dans l'étendue du package et dans l'étendue d'un conteneur, d'une tâche ou d'un gestionnaire d'événements donné.

Pour plus d’informations sur la portée des variables, consultez Variables Integration Services (SSIS).

Options pour les colonnes

Sélectionnez les colonnes que vous souhaitez afficher dans la fenêtre Variables .

  • Étendue

  • Type de données

  • Valeur

  • Espace de noms

  • Déclencher l'événement lorsque la valeur de la variable change

  • Description

  • Expression

Voir aussi

Variables Integration Services (SSIS)
Utiliser des variables dans des packages
Expressions Integration Services (SSIS)
Générer de fichiers de vidage pour l’exécution des packages