Définir les propriétés d'une variable définie par l'utilisateur

Pour définir les propriétés d'une variable définie par l'utilisateur dans Integration Services, vous pouvez utiliser l'une des fonctionnalités suivantes :

  • Fenêtre Variables.

  • Fenêtre Propriétés. La fenêtre Propriétés contient les propriétés de configuration des variables qui ne sont pas disponibles dans la fenêtre Variables : Description, EvaluateAsExpression, Expression, ReadOnly, ValueType et IncludeInDebugDump.

[!REMARQUE]

Integration Services fournit également un ensemble de variables système dont les propriétés ne peuvent pas être mises à jour, à l'exception de la propriété RaiseChangedEvent.

Définition des expressions dans les variables

Lorsque vous utilisez la fenêtre Propriétés pour définir les expressions d'une variable définie par l'utilisateur :

  • La valeur d'une variable peut être définie par la propriété Value ou Expression. Par défaut, la propriété EvaluateAsExpression a la valeur False et la valeur de la variable est définie par la propriété Value. Pour définir la valeur à l'aide d'une expression, vous devez commencer par donner la valeur True à EvaluateAsExpression, puis fournir une expression dans la propriété Expression. Le résultat de l'évaluation de l'expression est automatiquement affecté à la propriété Value.

  • La propriété ValueType contient le type de données de la valeur dans la propriété Value. Lorsque Value est défini au moyen d'une expression, ValueType est automatiquement mis à jour avec un type de données compatible avec le résultat de l'évaluation de l'expression. Par exemple, si Value contient 0, si ValueType contient Int32 et si vous affectez la valeur GETDATE() à Expression, Value contient la date et l'heure actuelles, et ValueType a la valeur DateTime.

  • La fenêtre Propriétés de la variable permet d'accéder à la boîte de dialogue Générateur d'expressions. Vous pouvez utiliser cet outil pour créer, valider et évaluer des expressions. Pour plus d'informations, consultez Générateur d'expressions et Expressions Integration Services (SSIS).

Lorsque vous utilisez la fenêtre Variables pour définir les expressions d'une variable définie par l'utilisateur :

  • Pour utiliser une expression pour définir la valeur de la variable, assurez-vous d'abord que le type de variable est compatible avec le résultat d'évaluation de l'expression et fournissez ensuite une expression dans la colonne Expression de la fenêtre Variables. La propriété EvaluateAsExpression dans la fenêtre Propriétés est automatiquement définie sur True.

  • Lorsque 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.

  • La fenêtre Variables de la variable permet d'accéder à la boîte de dialogue Générateur d'expressions. Vous pouvez utiliser cet outil pour créer, valider et évaluer des expressions. Pour plus d'informations, consultez Générateur d'expressions et Expressions Integration Services (SSIS).

Dans les fenêtres Variables et Propriétés, si vous affectez une expression à la variable, et EvaluateAsExpression est défini sur True, vous ne pouvez pas modifier le type de données de la variable.

Définition de l'espace de noms et des propriétés de nom

Les valeurs des propriétés Name et Namespace doivent commencer par une lettre conformément à la convention Unicode Standard 2.0, ou bien 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 bien un trait de soulignement (_).

Définition de propriétés à l'aide de la fenêtre Variables

Pour définir les propriétés d'une variable à l'aide de la fenêtre Variables

  1. Dans Outils de données SQL Server (SSDT), ouvrez le projet Integration Services contenant le package souhaité.

  2. Dans l'Explorateur de solutions, cliquez avec le bouton droit sur le package pour l'ouvrir.

  3. Dans le menu SSIS, cliquez sur Variables.

    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.

  4. Éventuellement, dans la fenêtre Variables cliquez sur Options de la grille, puis sélectionnez les colonnes qui apparaissent dans la fenêtre Variables et sélectionnez les filtres à appliquer à la liste des variables.

  5. Sélectionnez la variable dans la liste, puis mettez à jour les valeurs dans les colonnes Nom, Type de données, Valeur, Espace de noms, Déclencher l'événement lorsque la valeur de la variable change, Description et Expression.

  6. Sélectionnez la variable dans la liste, puis cliquez sur Déplacer la variable pour modifier l'étendue.

  7. Pour enregistrer le package mis à jour, dans le menu Fichier, cliquez sur Enregistrer les éléments sélectionnés.

Définition de propriétés à l'aide de la fenêtre Propriétés

Pour définir les propriétés d'une variable à l'aide de la fenêtre Propriétés

  1. Dans Outils de données SQL Server (SSDT), ouvrez le projet Integration Services qui contient le package souhaité.

  2. Dans l'Explorateur de solutions, cliquez avec le bouton droit sur le package pour l'ouvrir.

  3. Dans le menu Affichage, cliquez sur Fenêtre Propriétés.

  4. Dans le Concepteur SSIS, cliquez sur l'onglet Explorateur de package, puis développez le nœud Package.

  5. Pour modifier les variables avec une portée de package, développez le nœud Variables. Sinon, développez les nœuds Gestionnaires d'événements ou Exécutables jusqu'à ce que vous trouviez le nœud Variables contenant la variable que vous voulez modifier.

  6. Cliquez sur la variable dont vous souhaitez modifier les propriétés.

  7. Dans la fenêtre Propriétés, mettez à jour les propriétés en lecture/écriture de la variable. Certaines propriétés sont en lecture/lecture uniquement pour les variables définies par l'utilisateur.

    Pour plus d'informations sur les propriétés, consultez Variables Integration Services (SSIS).

  8. Pour enregistrer le package mis à jour, dans le menu Fichier, cliquez sur Enregistrer les éléments sélectionnés.

Voir aussi

Tâches

Utiliser des variables dans des packages

Ajouter, supprimer, modifier l'étendue de la variable définie par l'utilisateur dans un package

Concepts

Variables Integration Services (SSIS)