LEFT (Transact-SQL)

• 03/13/2017
• 2 minutes de lecture
• • c
  • j
  • r
  • .r
  • M
  • r
  • +8

S’applique à : SQL Server (toutes les versions prises en charge) Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Parallel Data Warehouse

Retourne la partie gauche d’une chaîne de caractères avec le nombre de caractères spécifié.

Conventions syntaxiques Transact-SQL

Syntaxe

LEFT ( character_expression , integer_expression ) 

Arguments

Expression_caractère
Est une expression de données de caractères ou binaires. expression_caractère peut être une constante, une variable ou une colonne. expression_caractère peut être de n’importe quel type de données, à l’exception de texte ou ntext, qui peut être implicitement converti en varchar ou nvarchar. Sinon, utilisez la fonction CAST pour convertir explicitement l’expression_caractère.

expression_intégrale
Est un entier positif qui spécifie combien de caractères de l’expression_caractère seront retournés. Si expression_entière est négative, une erreur est renvoyée. Si integer_expression est de type bigint et contient une grande valeur, character_expression doit être d’un grand type de données tel que varchar(max).

Le paramètre integer_expression compte un caractère de substitution UTF-16 comme un caractère.

Types de retour

Retourne varchar lorsque l’expression_caractère est un type de données de caractères non Unicode.

Retourne nvarchar lorsque l’expression_caractère est un type de données de caractères Unicode.

Remarques

Lorsque vous utilisez les collations SC, le paramètre expression_entière compte une paire de caractères de substitution UTF-16 comme un caractère. Pour plus d’informations, voir Collation et prise en charge d’Unicode.

Exemples

A. Utilisation de LEFT avec une colonne

L’exemple suivant renvoie les cinq caractères les plus à gauche de chaque nom de produit dans la table Product de la base de données AdventureWorks2012.

SELECT LEFT(Name, 5) FROM Production.Product ORDER BY ProductID; GO 

B. Utilisation de LEFT avec une chaîne de caractères

L’exemple suivant utilise LEFT pour retourner les deux caractères les plus à gauche de la chaîne de caractères abcdefg.

SELECT LEFT('abcdefg',2); GO 

Voici le jeu de résultats.

-- ab (1 row(s) affected) 

Exemples : Azure Synapse Analytics et Parallel Data Warehouse

C. Utilisation de LEFT avec une colonne

L’exemple suivant renvoie les cinq caractères les plus à gauche de chaque nom de produit.

-- Uses AdventureWorks SELECT LEFT(EnglishProductName, 5) FROM dbo.DimProduct ORDER BY ProductKey; 

D. Utiliser LEFT avec une chaîne de caractères

L’exemple suivant utilise LEFT pour retourner les deux caractères les plus à gauche de la chaîne de caractères abcdefg.

-- Uses AdventureWorks SELECT LEFT('abcdefg',2) FROM dbo.DimProduct; 

Voici l’ensemble des résultats.

-- ab 

Voir aussi

LTRIM (Transact-SQL)
RIGHT (Transact-SQL)
RTRIM (Transact-SQL)
STRING_SPLIT (Transact-.SQL)
SUBSTRING (Transact-SQL)
TRIM (Transact-SQL)
CAST et CONVERT (Transact-SQL)
Types de données (Transact-SQL)
Fonctions chaîne de caractères (Transact-SQL)