LEFT (Transact-SQL)

S’applique à :SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)Point de terminaison analytique SQL dans Microsoft FabricEntrepôt dans Microsoft Fabric

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

Conventions de la syntaxe Transact-SQL

Syntaxe

LEFT ( character_expression , integer_expression )  

Arguments

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

integer_expression
Entier positif qui spécifie le nombre de caractères de character_expression à renvoyer. Si integer_expression est négatif, une erreur est retournée. Si integer_expression est de type bigint et contient une valeur de grande taille, character_expression doit être d’un type de données de grande taille, 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 quand character_expression est un type de données caractères non-Unicode.

Retourne nvarchar quand character_expression est un type de données caractères Unicode.

Notes

Lors de l’utilisation de classements SC, le paramètre integer_expression compte une paire de substitution UTF-16 comme un caractère. Pour plus d’informations, consultez Prise en charge d’Unicode et du classement.

Exemples

R. Utilisation de LEFT avec une colonne

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

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 obtenu.

--   
ab   
  
(1 row(s) affected)  

Exemples : Azure Synapse Analytics et Analytics Platform System (PDW)

C. Utilisation de LEFT avec une colonne

L'exemple suivant retourne les cinq caractères les plus à gauche du nom de chaque produit.

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

D. 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.

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

Voici le jeu de résultats obtenu.

--   
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 de chaîne (Transact-SQL)