SUBSTRING (Expression SSIS)
Renvoie la partie d'une expression de caractères qui commence à la position spécifiée et qui a la longueur spécifiée. Les paramètres position et length doivent correspondre à des entiers.
Syntaxe
SUBSTRING(character_expression, position, length)
Arguments
character_expression
Expression de caractères à partir de laquelle doivent être extraits les caractères.position
Entier précisant où commence sous-chaîne.length
Entier exprimant, en nombre de caractères, la longueur de la sous-chaîne.
Types des résultats
DT_WSTR
Notes
SUBSTRING utilise un index de base un. Si l'argument position a pour valeur 1, la sous-chaîne commence au premier caractère de l'argument character_expression.
La fonction SUBSTRING n'est opérationnelle qu'avec le type de données DT_WSTR. Un argument character_expression représentant un littéral de chaîne ou une colonne de données du type de données DT_STR est implicitement converti dans le type de données DT_WSTR avant que la fonction SUBSTRING soit exécutée. Les autres types de données doivent être explicitement convertis vers le type de données DT_WSTR. Pour plus d'informations, consultez Types de données d'Integration Services et Cast (Expression SSIS) : conversion de types de données SSIS.
La fonction SUBSTRING renvoie un résultat NULL si l'argument est NULL.
Tous les arguments de l'expression peuvent utiliser des variables et des colonnes.
L'argument length peut être supérieur à la longueur de la chaîne. Dans ce cas, la fonction renvoie le reste de la chaîne.
Exemples
L'exemple suivant renvoie deux caractères, à partir du quatrième caractère, d'un littéral de chaîne. Le résultat obtenu est « ph ».
SUBSTRING("elephant",4,2)
L'exemple suivant renvoie le reste d'un littéral de chaîne, à partir du quatrième caractère. Le résultat obtenu est « phant ». Si l'argument length dépasse la longueur de la chaîne, cela ne constitue pas une erreur.
SUBSTRING ("elephant",4,50)
L'exemple suivant renvoie la première lettre de la colonne MiddleName.
SUBSTRING(MiddleName,1,1)
L'exemple suivant utilise des variables dans les arguments position et length. Si les variables Start et Length ont pour valeur respective 1 et 5, la fonction renvoie les cinq premiers caractères de la colonne Name.
SUBSTRING(Name,@Start,@Length)
L'exemple suivant renvoie les quatre derniers caractères de la variable PostalCode , à partir du sixième caractère.
SUBSTRING (@PostalCode,6,4)
L'exemple suivant renvoie une chaîne de longueur nulle d'un littéral de chaîne.
SUBSTRING ("Redmond",4,0)