LEFT (Transact-SQL)
S’applique à : point de terminaison d’analytique SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Platform System (PDW) SQL Analytics dans Microsoft Fabric Warehouse 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 )
Remarque
Pour afficher la syntaxe Transact-SQL pour SQL Server 2014 (12.x) et versions antérieures, consultez la Documentation sur les versions antérieures.
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.
Notes
Si string_expression est de type binary ou varbinary, LEFT effectuera une conversion implicite vers varchar, et ne préservera donc pas l’entrée binaire.
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)