LEFT (Transact-SQL)LEFT (Transact-SQL)

CETTE RUBRIQUE S’APPLIQUE À :ouiSQL Server (à partir de la version 2008)ouiAzure SQL DatabaseouiAzure SQL Data Warehouse ouiParallel Data Warehouse THIS TOPIC APPLIES TO: yesSQL Server (starting with 2008)yesAzure SQL DatabaseyesAzure SQL Data Warehouse yesParallel Data Warehouse

Retourne la partie de gauche d'une chaîne de caractères avec le nombre spécifié de caractères.Returns the left part of a character string with the specified number of characters.

Icône de lien de rubrique Conventions de la syntaxe Transact-SQLTopic link icon Transact-SQL Syntax Conventions

SyntaxeSyntax

LEFT ( character_expression , integer_expression )  

ArgumentsArguments

character_expressioncharacter_expression
Est un expression de type binaire ou caractère.Is an expression of character or binary data. character_expression peut être une constante, une variable ou une colonne.character_expression can be a constant, variable, or column. character_expression peut être de n’importe quel type de données, à l’exception de texte ou ntext, qui peut être converti implicitement en varchar ou nvarchar.character_expression can be of any data type, except text or ntext, that can be implicitly converted to varchar or nvarchar. Sinon, utilisez le CAST fonction pour convertir explicitement character_expression.Otherwise, use the CAST function to explicitly convert character_expression.

integer_expressioninteger_expression
Est un entier positif qui spécifie le nombre de caractères de la character_expression sera retourné.Is a positive integer that specifies how many characters of the character_expression will be returned. Si expression_entier est négatif, une erreur est retournée.If integer_expression is negative, an error is returned. Si expression_entier est de type bigint et contient une valeur élevée, character_expression doit être d’un type de données de grande taille, tel que varchar (max).If integer_expression is type bigint and contains a large value, character_expression must be of a large data type such as varchar(max).

Le expression_entier paramètre compte un caractère de substitution UTF-16 comme un caractère.The integer_expression parameter counts a UTF-16 surrogate character as one character.

Types de retourReturn Types

Retourne varchar lorsque character_expression est un type de données de caractères non-Unicode.Returns varchar when character_expression is a non-Unicode character data type.

Retourne nvarchar lorsque character_expression est un type de données de caractères Unicode.Returns nvarchar when character_expression is a Unicode character data type.

NotesRemarks

Lors de l’utilisation de classements SC, la expression_entier paramètre compte une paire de substitution UTF-16 comme un caractère.When using SC collations, the integer_expression parameter counts a UTF-16 surrogate pair as one character. Pour plus d’informations, consultez Collation and Unicode Support.For more information, see Collation and Unicode Support.

ExemplesExamples

A.A. Utilisation de LEFT avec une colonneUsing LEFT with a column

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 AdventureWorks2012AdventureWorks2012.The following example returns the five leftmost characters of each product name in the Product table of the AdventureWorks2012AdventureWorks2012 database.

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

B.B. Utilisation de LEFT avec une chaîne de caractèresUsing LEFT with a character string

L'exemple suivant utilise LEFT pour retourner les deux caractères les plus à gauche de la chaîne de caractères abcdefg.The following example uses LEFT to return the two leftmost characters of the character string abcdefg.

SELECT LEFT('abcdefg',2);  
GO  

Voici l'ensemble des résultats.Here is the result set.

--   
ab   

(1 row(s) affected)  

Exemples : Azure SQL Data WarehouseAzure SQL Data Warehouse et Parallel Data WarehouseParallel Data WarehouseExamples: Azure SQL Data WarehouseAzure SQL Data Warehouse and Parallel Data WarehouseParallel Data Warehouse

C.C. Utilisation de LEFT avec une colonneUsing LEFT with a column

L'exemple suivant retourne les cinq caractères les plus à gauche du nom de chaque produit.The following example returns the five leftmost characters of each product name.

-- Uses AdventureWorks  

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

D.D. Utilisation de LEFT avec une chaîne de caractèresUsing LEFT with a character string

L'exemple suivant utilise LEFT pour retourner les deux caractères les plus à gauche de la chaîne de caractères abcdefg.The following example uses LEFT to return the two leftmost characters of the character string abcdefg.

-- Uses AdventureWorks  

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

Voici l'ensemble des résultats.Here is the result set.

--   
ab  

Voir aussiSee Also

LTRIM (Transact-SQL)LTRIM (Transact-SQL)
RIGHT (Transact-SQL)RIGHT (Transact-SQL)
RTRIM (Transact-SQL)RTRIM (Transact-SQL)
STRING_SPLIT (Transact-SQL)STRING_SPLIT (Transact-SQL)
SUBSTRING (Transact-SQL)SUBSTRING (Transact-SQL)
TRIM (Transact-SQL)TRIM (Transact-SQL)
CAST et CONVERT (Transact-SQL) CAST and CONVERT (Transact-SQL)
Types de données (Transact-SQL) Data Types (Transact-SQL)
Fonctions de chaîne ( Transact-SQL )String Functions (Transact-SQL)