Partager via

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

  • Article

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 répertorie les propriétés pour la configuration des variables qui ne sont pas disponibles dans la fenêtre Variables : Description, EvaluateAsExpression, Expression, ReadOnly, ValueType et IncludeInDebugDump.

Notes

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

Quand vous utilisez la fenêtre Propriétés pour définir des expressions sur une variable définie par l’utilisateur :

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

  • La propriété ValueType contient le type de données de la valeur de la propriété Valeur. Quand Valeur est définie par 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 et si la propriété ValueType contient Int32 et que vous définissez Expression sur GETDATE(), Value contient la date et l’heure actuelles et ValueType est défini sur DateTime.

  • La fenêtre Propriétés pour 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).

Quand vous utilisez la fenêtre Variables pour définir des expressions sur une variable définie par l’utilisateur :

  • Pour utiliser une expression pour définir la valeur de la variable, vérifiez d’abord que le type de données de variable est compatible avec le résultat d’évaluation de l’expression, puis fournissez une expression dans la Expression colonne de la fenêtre Variables . La propriété EvaluateAsExpression de 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 pour 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 la fenêtre 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 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 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 (_).

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 SQL Server Data Tools (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 Namecolonnes , Type de données , Value, Namespace, Déclencherl’événement de modification, 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 SQL Server Data Tools (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 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

Variables Integration Services (SSIS)
Utiliser des variables dans des packages
Ajouter, supprimer, modifier l'étendue de la variable définie par l'utilisateur dans un package