SUBSTRING (Transact-SQL)SUBSTRING (Transact-SQL)

S’APPLIQUE À : ouiSQL Server ouiAzure SQL Database ouiAzure Synapse Analytics (SQL DW) ouiParallel Data Warehouse APPLIES TO: yesSQL Server yesAzure SQL Database yesAzure Synapse Analytics (SQL DW) yesParallel Data Warehouse

Retourne une partie d'une expression de type caractère, binaire, texte ou image dans SQL ServerSQL Server.Returns part of a character, binary, text, or image expression in SQL ServerSQL Server.

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

SyntaxeSyntax

SUBSTRING ( expression ,start , length )  

ArgumentsArguments

expressionexpression
Est une expression de type character, binary, text, ntext ou image expression.Is a character, binary, text, ntext, or image expression.

startstart
Expression entière ou bigint qui spécifie où les caractères retournés commencent.Is an integer or bigint expression that specifies where the returned characters start. (La numérotation est basée sur 1, ce qui signifie que le premier caractère de l’expression est 1).(The numbering is 1 based, meaning that the first character in the expression is 1). Si start est inférieur à 1, l’expression retournée commence au premier caractère spécifié dans expression.If start is less than 1, the returned expression will begin at the first character that is specified in expression. Dans ce cas, le nombre de caractères retournés correspond à la valeur la plus grande entre la somme de start + length- 1 et 0.In this case, the number of characters that are returned is the largest value of either the sum of start + length- 1 or 0. Si start est supérieur au nombre de caractères dans l’expression de valeur, une expression de longueur nulle est retournée.If start is greater than the number of characters in the value expression, a zero-length expression is returned.

lengthlength
Expression bigint ou entière positive qui spécifie le nombre de caractères d’expression à retourner.Is a positive integer or bigint expression that specifies how many characters of the expression will be returned. Si length est négatif, une erreur est générée et l’instruction est arrêtée.If length is negative, an error is generated and the statement is terminated. Si la somme de start et length est supérieure au nombre de caractères dans expression, l’expression de valeur entière qui commence à start est retournée.If the sum of start and length is greater than the number of characters in expression, the whole value expression beginning at start is returned.

Types de retourReturn Types

Retourne des données de type caractère si expression correspond à l’un des types de données caractères pris en charge.Returns character data if expression is one of the supported character data types. Retourne des données binaires si expression correspond à l’un des types de données binary pris en charge.Returns binary data if expression is one of the supported binary data types. La chaîne retournée est du même type que l'expression spécifiée, sauf pour les exceptions énumérées dans le tableau suivant :The returned string is the same type as the specified expression with the exceptions shown in the table.

Expression spécifiéeSpecified expression Type de retourReturn type
char/varchar/textchar/varchar/text varcharvarchar
nchar/nvarchar/ntextnchar/nvarchar/ntext nvarcharnvarchar
binary/varbinary/imagebinary/varbinary/image varbinaryvarbinary

NotesRemarks

Les valeurs de start et length doivent être spécifiées en nombre de caractères pour les types de données ntext, char ou varchar et en octets pour les types de données text, image, binary ou varbinary.The values for start and length must be specified in number of characters for ntext, char, or varchar data types and bytes for text, image, binary, or varbinary data types.

expression doit être de type varchar(max) ou varbinary(max) lorsque start ou length contient une valeur supérieure à 2147483647.The expression must be varchar(max) or varbinary(max) when the start or length contains a value larger than 2147483647.

Caractères supplémentaires (paires de substitution)Supplementary Characters (Surrogate Pairs)

Lors de l’utilisation des classements de caractères supplémentaires (SC), les arguments start et length comptent chaque paire de substitution dans expression comme un caractère unique.When using supplementary character (SC) collations, both start and length count each surrogate pair in expression as a single character. Pour plus d’informations, consultez Prise en charge d’Unicode et du classement.For more information, see Collation and Unicode Support.

ExemplesExamples

A.A. Utilisation de SUBSTRING avec une chaîne de caractèresUsing SUBSTRING with a character string

L'exemple suivant illustre la manière de retourner uniquement une partie d'une chaîne de caractères.The following example shows how to return only a part of a character string. À partir de la table sys.databases, cette requête retourne les noms de base de données système dans la première colonne, la première lettre de la base de données dans la deuxième colonne et les troisième et quatrième caractères dans la colonne finale.From the sys.databases table, this query returns the system database names in the first column, the first letter of the database in the second column, and the third and fourth characters in the final column.

SELECT name, SUBSTRING(name, 1, 1) AS Initial ,
SUBSTRING(name, 3, 2) AS ThirdAndFourthCharacters
FROM sys.databases  
WHERE database_id < 5;   

Voici le jeu de résultats obtenu.Here is the result set.

NAMEname InitialInitial ThirdAndFourthCharactersThirdAndFourthCharacters
mastermaster mm stst
tempdbtempdb tt mpmp
modelmodel mm dede
msdbmsdb mm dbdb

Voici comment afficher les deuxième, troisième et quatrième caractères de la constante de chaîne abcdef :Here is how to display the second, third, and fourth characters of the string constant abcdef.

SELECT x = SUBSTRING('abcdef', 2, 3);  

Voici le jeu de résultats obtenu.Here is the result set.

x  
----------  
bcd  
 
(1 row(s) affected)

B.B. Utilisation de SUBSTRING avec des données text, ntext et imageUsing SUBSTRING with text, ntext, and image data

Notes

Pour exécuter les exemples suivants, vous devez installer la base de données pubs.To run the following examples, you must install the pubs database.

L’exemple suivant montre comment retourner les 10 premiers caractères de chaque colonne de données text et image de la table pub_info de la base de données pubs.The following example shows how to return the first 10 characters from each of a text and image data column in the pub_info table of the pubs database. Les données text sont retournées en tant que données varchar et les données image sont retournées en tant que varbinary.text data is returned as varchar, and image data is returned as varbinary.

USE pubs;  
SELECT pub_id, SUBSTRING(logo, 1, 10) AS logo,   
   SUBSTRING(pr_info, 1, 10) AS pr_info  
FROM pub_info  
WHERE pub_id = '1756';  

Voici le jeu de résultats obtenu.Here is the result set.

pub_id logo    pr_info
------ ---------------------- ----------
1756   0x474946383961E3002500 This is sa

(1 row(s) affected)

L’exemple suivant illustre l’effet de SUBSTRING sur les données text et ntext.The following example shows the effect of SUBSTRING on both text and ntext data. D'abord, cet exemple crée, dans la base de données pubs, une nouvelle table nommée npub_info.First, this example creates a new table in the pubs database named npub_info. Ensuite, l'exemple crée la colonne pr_info dans la table npub_info à partir des 80 premiers caractères de la colonne pub_info.pr_info puis ajoute le caractère ü en guise de premier caractère.Second, the example creates the pr_info column in the npub_info table from the first 80 characters of the pub_info.pr_info column and adds an ü as the first character. Pour finir, une opération INNER JOIN extrait tous les numéros d’identification de serveur de publication et le SUBSTRING des deux colonnes d’informations de serveur de publication text et ntext.Lastly, an INNER JOIN retrieves all publisher identification numbers and the SUBSTRING of both the text and ntext publisher information columns.

IF EXISTS (SELECT table_name FROM INFORMATION_SCHEMA.TABLES   
      WHERE table_name = 'npub_info')  
   DROP TABLE npub_info;  
GO  
-- Create npub_info table in pubs database. Borrowed from instpubs.sql.  
USE pubs;  
GO  
CREATE TABLE npub_info  
(  
 pub_id char(4) NOT NULL  
    REFERENCES publishers(pub_id)  
    CONSTRAINT UPKCL_npubinfo PRIMARY KEY CLUSTERED,  
pr_info ntext NULL  
);  
  
GO  
  
-- Fill the pr_info column in npub_info with international data.  
RAISERROR('Now at the inserts to pub_info...',0,1);  
  
GO  
  
INSERT npub_info VALUES('0736', N'üThis is sample text data for New Moon Books, publisher 0736 in the pubs database')  
,('0877', N'üThis is sample text data for Binnet & Hardley, publisher 0877 in the pubs databa')  
,('1389', N'üThis is sample text data for Algodata Infosystems, publisher 1389 in the pubs da')  
,('9952', N'üThis is sample text data for Scootney Books, publisher 9952 in the pubs database')  
,('1622', N'üThis is sample text data for Five Lakes Publishing, publisher 1622 in the pubs d')  
,('1756', N'üThis is sample text data for Ramona Publishers, publisher 1756 in the pubs datab')  
,('9901', N'üThis is sample text data for GGG&G, publisher 9901 in the pubs database. GGG&G i')  
,('9999', N'üThis is sample text data for Lucerne Publishing, publisher 9999 in the pubs data');  
GO  
-- Join between npub_info and pub_info on pub_id.  
SELECT pr.pub_id, SUBSTRING(pr.pr_info, 1, 35) AS pr_info,  
   SUBSTRING(npr.pr_info, 1, 35) AS npr_info  
FROM pub_info pr INNER JOIN npub_info npr  
   ON pr.pub_id = npr.pub_id  
ORDER BY pr.pub_id ASC;  

Exemples : Azure Synapse Analytics (SQL DW)Azure Synapse Analytics (SQL DW) et Parallel Data WarehouseParallel Data WarehouseExamples: Azure Synapse Analytics (SQL DW)Azure Synapse Analytics (SQL DW) and Parallel Data WarehouseParallel Data Warehouse

C.C. Utilisation de SUBSTRING avec une chaîne de caractèresUsing SUBSTRING with a character string

L'exemple suivant illustre la manière de retourner uniquement une partie d'une chaîne de caractères.The following example shows how to return only a part of a character string. À partir de la table dbo.DimEmployee, cette requête retourne les noms de famille dans une colonne avec seulement la première initiale des prénoms dans la seconde colonne.From the dbo.DimEmployee table, this query returns the last name in one column with only the first initial in the second column.

-- Uses AdventureWorks  
  
SELECT LastName, SUBSTRING(FirstName, 1, 1) AS Initial  
FROM dbo.DimEmployee  
WHERE LastName LIKE 'Bar%'  
ORDER BY LastName;  

Voici le jeu de résultats obtenu.Here is the result set.

LastName             Initial
-------------------- -------
Barbariol            A
Barber               D
Barreto de Mattos    P

L’exemple suivant montre comment retourner les deuxième, troisième et quatrième caractères de la constante chaîne abcdef.The following example shows how to return the second, third, and fourth characters of the string constant abcdef.

USE ssawPDW;  
  
SELECT TOP 1 SUBSTRING('abcdef', 2, 3) AS x FROM dbo.DimCustomer;  

Voici le jeu de résultats obtenu.Here is the result set.

x
-----
bcd

Voir aussiSee Also

LEFT (Transact-SQL)LEFT (Transact-SQL)
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)
TRIM (Transact-SQL)TRIM (Transact-SQL)
Fonctions de chaîne (Transact-SQL)String Functions (Transact-SQL)