LEFT (expression SSIS)

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

Renvoie le nombre de caractères spécifié en commençant par la partie la plus à gauche d'une expression de caractères donnée.

Syntaxe

  
LEFT(character_expression,number)  

Arguments

expression_caractère
Expression de caractères à partir de laquelle doivent être extraits les caractères.

number
Expression entière indiquant le nombre de caractères à renvoyer.

Types des résultats

DT_WSTR

Notes

Si number est supérieur à la longueur de character_expression, la fonction retourne character_expression.

Si l'argument number a pour valeur zéro, la fonction renvoie une chaîne de longueur nulle.

Si l'argument number est un nombre négatif, la fonction renvoie une erreur.

L'argument number peut accepter des variables et des colonnes.

La fonction LEFT fonctionne seulement avec le type de données DT_WSTR. Un argument character_expression qui est un littéral de chaîne ou une colonne de données avec le type de données DT_STR est implicitement converti dans le type de données DT_WSTR avant que LEFT effectue son opération. 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 Integration Services et Cast (expression SSIS).

La fonction LEFT renvoie un résultat NULL si l'un des arguments est NULL.

Exemples d'expressions

L'exemple suivant utilise un littéral de chaîne. Le résultat obtenu est "Mountain".

LEFT("Mountain Bike", 8)  

Voir aussi

RIGHT (expression SSIS)
Fonctions (expression SSIS)