Identificateurs (SSIS)

Dans les expressions, les identificateurs sont des colonnes et des variables disponibles pour l'opération. Les expressions peuvent utiliser des identificateurs standard et qualifiés. Un identificateur standard ne requiert aucun qualificateur supplémentaire. Par exemple, la colonne MiddleName de la table Contacts de la base de données AdventureWorks est un identificateur standard. Un identificateur qualifié est un identificateur délimité par des crochets. Un identificateur peut nécessiter un délimiteur, car son nom comprend des espaces ou son premier caractère n'est ni une lettre, ni un trait de soulignement. Par exemple, le nom de colonne Middle Name doit être qualifié par des crochets et exprimé sous la forme « [Middle Name] » dans une expression.

Un package peut inclure des sources de données qui exposent des colonnes de même nom. Pour lever l'ambiguïté sur les colonnes, l'évaluateur d'expression prend en charge une notation ponctuée qui qualifie le nom de la colonne avec son nom source. Par exemple, si la source est nommée « GetGeographyData » et la colonne « GeographyKey », la colonne peut être référencée sous la forme « GetGeographyData.GeographyKey ».

Un package peut posséder plusieurs variables de même nom sous réserve qu'elles appartiennent à différents espaces de noms. L'évaluateur d'expression fournit un opérateur de résolution d'espace de noms qui permet d'identifier les variables à l'aide d'espaces de noms. Pour plus d'informations, consultez Syntaxe (SSIS).

Identificateurs standard

La dénomination des identificateurs standard doit suivre les règles suivantes :

• Le premier caractère du nom doit être une lettre, comme défini dans le standard Unicode 2.0, ou un trait de soulignement « _ ».
• Les caractères suivants peuvent être des lettres ou des nombres, comme défini dans le standard Unicode 2.0, le trait de soulignement « _ » et les caractères « @ », « $ » et « # ».

Important :
Il n'est pas autorisé d'incorporer dans les identificateurs standard des espaces et des caractères spéciaux, autres que ceux qui sont répertoriés. Pour recourir à des espaces et à des caractères spéciaux, vous devez utiliser un identificateur qualifié au lieu d'un identificateur standard.

Identificateurs qualifiés

Si le nom de l'identificateur comprend des espaces ou qu'il ne s'agit pas d'un nom d'identificateur standard valide, l'identificateur doit être qualifié. L'évaluateur d'expression utilise les crochets ouvrant et fermant ( [] ) pour qualifier les identificateurs. Les crochets occupent la première et la dernière position de la chaîne. Par exemple, l'identificateur 5$> devient [5$>]. Les crochets peuvent être utilisés avec des noms de colonne, de variable et de fonction.

Si vous créez des expressions à l'aide des boîtes de dialogue du concepteur SSIS, les identificateurs standard sont automatiquement placés entre crochets. Toutefois, les crochets sont requis uniquement si le nom comprend des caractères non valides. Par exemple, la colonne MiddleName est valide sans crochets.

Dans les expressions, vous ne pouvez pas référencer des noms de colonne comprenant des crochets. Par exemple, le nom de colonne Colonne[1] ne peut pas être utilisé dans une expression. Pour utiliser la colonne dans une expression, vous devez lui attribuer un nom dépourvu de crochets.

Identificateurs de lignage

Les expressions peuvent utiliser des identificateurs de lignage pour faire référence aux colonnes. Les identificateurs de lignage sont automatiquement affectés lorsque vous créez le package. Vous pouvez visualiser l'identificateur de lignage d'une colonne dans l'onglet Propriétés de la colonne de la boîte de dialogue Éditeur avancé du concepteur SSIS.

Si vous faites référence à une colonne à l'aide de son identificateur de lignage, celui-ci doit être préfixé du signe dièse ( # ). Par exemple, une colonne dont l'identificateur de lignage est 147 doit être référencée sous la forme « #147 ».

Si une expression est correctement analysée, l'évaluateur d'expression remplace les identificateurs de lignage par des noms de colonne dans la boîte de dialogue.

Noms de colonne uniques

Plusieurs composants utilisés dans un package peuvent exposer des colonnes de même nom. Si ces colonnes sont utilisées dans des expressions, toute ambiguïté doit être levée afin que celles-ci soient correctement analysées. L'évaluateur d'expression prend en charge la notation ponctuée afin d'identifier la source de la colonne. Par exemple, deux colonnes nommées Age sont renommées « FlatFileSource.Age » et « OLEDBSource.Age », ce qui indique que leurs sources sont FlatFileSource ou OLEDBSource. L'analyseur traite le nom qualifié complet en tant que nom de colonne unique.

Les noms de colonne et les noms de composant source sont qualifiés séparément. Les exemples suivants illustrent l'utilisation des crochets dans une notation ponctuée :

• Le nom du composant source comprend des espaces.

  [MySo urce].Age
  

• Le premier caractère du nom de la colonne n'est pas valide.

  MySource.[#Age]
  

• Les noms de la colonne et du composant source contiennent des caractères non valides.

  [MySource?].[#Age]
  

Important :
Si les deux éléments en notation ponctuée figurent dans une paire de crochets, l'évaluateur d'expression interprète celle-ci comme un identificateur unique, et non pas comme une combinaison de colonnes source.

Variables dans des expressions

Les variables référencées dans les expressions doivent comprendre le préfixe « @ ». Par exemple, la variable Counter est référencée sous la forme « @Counter ». Le caractère « @ » ne fait pas partie du nom de la variable ; il permet simplement à l'évaluateur d'expression d'identifier la variable. Si vous créez des expressions à l'aide des boîtes de dialogue du concepteur SSIS, le caractère « @ » est automatiquement ajouté au nom de la variable. Vous ne pouvez pas insérer des espaces entre le caractère « @ » et le nom de la variable.

Les noms de variable suivent les mêmes règles que ceux des autres identificateurs standard :

• Le premier caractère du nom doit être une lettre, comme défini dans le standard Unicode 2.0, ou un trait de soulignement « _ ».
• Les caractères suivants peuvent être des lettres ou des nombres, comme défini dans le standard Unicode 2.0, le trait de soulignement « _ » et les caractères « @ », « $ » et « # ».

Si un nom de variable contient des caractères autres que ceux répertoriés, vous devez placer la variable entre crochets. Par exemple, les noms de variable contenant des espaces doivent figurer entre crochets. Le crochet ouvrant suit le caractère « @ ». Par exemple, la variable Mon nom est référencée sous la forme « @[Mon nom] ». Vous ne pouvez pas insérer des espaces entre le nom de la variable et les crochets.

Remarque :
Les noms des variables système et des variables définies par l'utilisateur respectent la casse.

Noms de variable uniques

Integration Services prend en charge les variables personnalisées et met à votre disposition un ensemble de variables système. Par défaut, les variables personnalisées appartiennent à l'espace de noms User et les variables système à l'espace de noms System. Vous pouvez créer des espaces de noms supplémentaires pour les variables personnalisées et mettre à jour les noms d'espace de noms en fonction des besoins de votre application. Le générateur d'expressions répertorie dans tous les espaces de noms les variables qui sont dans leur portée respective.

Toutes les variables ont une portée et appartiennent à un espace de noms. Une variable a la portée d'un package ou celle d'un conteneur ou d'une tâche appartenant au package. Le générateur d'expressions du concepteur SSIS ne répertorie que les variables comprises dans la portée. Pour plus d'informations, consultez Variables Integration Services et Utilisation de variables dans des packages.

L'évaluateur d'expression ne peut correctement évaluer les expressions que si les variables utilisées dans celles-ci portent des noms uniques. Si un package utilise plusieurs variables de même nom, leurs espaces de noms doivent être différents. Integration Services a un opérateur de résolution d'espace de noms, constitué de deux points (::), qui permet de qualifier une variable avec son espace de noms. Par exemple, l'expression suivante utilise deux variables nommées Count ; l'une appartient à l'espace de noms User , l'autre à l'espace de noms MyNamespace.

@[User::Count] > @[MyNamespace::Count]

Important :
Vous devez placer la combinaison de l'espace de noms et du nom de la variable qualifiée entre crochets pour que l'évaluateur d'expression puisse reconnaître la variable.

Si la variable Count de l'espace de noms User a pour valeur 10 et que la variable Count de l'espace de noms MyNamespace a pour valeur 2, l'expression retourne la valeur true, car l'évaluateur d'expression reconnaît deux variables différentes.

Si les noms de variable ne sont pas uniques, aucune erreur ne se produit. Par contre, l'évaluateur d'expression utilise une seule instance de la variable pour évaluer l'expression et renvoie un résultat incorrect. Par exemple, l'expression suivante est conçue pour comparer les valeurs (10 et 2) de deux variables Count distinctes mais renvoie la valeur false, car l'évaluateur d'expression utilise deux fois la même instance de cette variable.

@Count > @Count

Voir aussi

Autres ressources

Concepts des expressions Integration Services

Aide et Informations

Assistance sur SQL Server 2005