SOUS-CHAÎNE (Transact-SQL)

2025-04-16

S’applique à :SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW)SQL analytics endpoint in Microsoft Fabric Warehouse in Microsoft Fabric

Retourne une partie d'une expression de type caractère, binaire, texte ou image dans SQL Server.

Conventions de la syntaxe Transact-SQL

Syntaxe

Syntaxe de SQL Server.

SUBSTRING ( expression , start , length )

Syntaxe pour Azure SQL Database, Azure SQL Managed Instance, Azure Synapse Analytics, Analytics Platform System (PDW) et entrepôt et point de terminaison d’analytique SQL dans Microsoft Fabric.

SUBSTRING ( expression , start [ , length ] )

Les arguments

expression

Caractère,binaire, texte, ntext ou expressiond’image.

démarrer

Expression entière ou bigint qui spécifie l’emplacement de début des caractères retournés. (La numérotation est basée sur 1, ce qui signifie que le premier caractère de l’expression est 1). Si le début est inférieur à 1, l’expression retournée commence au premier caractère spécifié dans l’expression. Dans ce cas, le nombre de caractères retournés est la plus grande valeur de la somme de lalongueur de + - 1 ou 0. Si start est supérieur au nombre de caractères dans l’expression de valeur, une expression de longueur nulle est retournée.

longueur

Entier positif ou expression bigint qui spécifie le nombre de caractères de l’expression retournés. Si length est négatif, une erreur est générée et l’instruction est arrêtée. 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. Si la longueur est omise, tous les caractères de la position de début à la fin de l’expression sont retournés.

Vous pouvez utiliser la sous-chaîne avec un argument de longueur facultatif dans Azure SQL Database, Azure SQL Managed Instance, Azure Synapse Analytics, Analytics Platform System (PDW) et un point de terminaison d’analytique SQL dans Microsoft Fabric. Toutefois, si vous utilisez NULL pour la longueur, SUBSTRING retourne NULL. Passez en revue E. Utilisez SUBSTRING avec un argument de longueur facultatif pour un exemple.

Types de retour

Retourne des données de type caractère si expression correspond à l’un des types de données caractères pris en charge. Retourne des données binaires si expression correspond à l’un des types de données binary pris en charge. 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 :

Expression spécifiée	Type de retour
carboniser / varchar / SMS	varchar
nchar / nvarchar / ntext	nvarchar
binaire / varbinary / image	varbinary

Notes

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.

L’expression doit être varchar(max) ou varbinary(max) lorsque le début ou la longueur contient une valeur supérieure à 2 147 483 647.

Caractères supplémentaires (paires de substitution)

Lorsque vous utilisez des classements de caractères supplémentaires (SC), le nombre de débuts et de longueur de chaque paire de substitution dans l’expression en tant que caractère unique. Pour plus d’informations, voir Classement et prise en charge d’Unicode.

Exemples

R. Utiliser SUBSTRING avec une chaîne de caractères

L'exemple suivant illustre la manière de retourner uniquement une partie d'une chaîne de caractères. À 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.

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.

nom	Initial	TroisièmeEtQuatrièmePersonnages
`master`	`m`	`st`
`tempdb`	`t`	`mp`
`model`	`m`	`de`
`msdb`	`m`	`db`

Pour afficher les deuxième, troisième et quatrième caractères de la constante abcdefde chaîne, utilisez la requête suivante.

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

Voici le jeu de résultats.

x
----------
bcd

B. Utiliser SUBSTRING avec du texte, ntext et des données d’image

Notes

Pour exécuter les exemples suivants, vous devez installer la base de données pubs.

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

USE pubs;
GO

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.

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

L’exemple suivant montre l’effet des SUBSTRING données texte et ntext . D'abord, cet exemple crée, dans la base de données pubs, une nouvelle table nommée 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. 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.

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 FOREIGN KEY
        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 AS pr
     INNER JOIN npub_info AS npr
         ON pr.pub_id = npr.pub_id
ORDER BY pr.pub_id ASC;

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

Chapitre C. Utiliser SUBSTRING avec une chaîne de caractères

L'exemple suivant illustre la manière de retourner uniquement une partie d'une chaîne de caractères. Dans la dbo.DimEmployee table, cette requête retourne le nom de la famille dans une colonne avec uniquement le premier initial de la deuxième colonne.

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

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.

USE ssawPDW;

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

Voici le jeu de résultats.

x
-----
bcd

D. Utiliser SUBSTRING avec `NULL` l’argument de longueur

SELECT SUBSTRING('123abc', 4, NULL) AS [NULL length];

Voici le jeu de résultats.

NULL length
-----------
NULL

E. Utiliser SUBSTRING avec un argument de longueur facultatif

S’applique à : Azure SQL Database, Azure SQL Managed Instance, Azure Synapse Analytics, Analytics Platform System (PDW) et entrepôt et point de terminaison d’analytique SQL dans Microsoft Fabric

L’exemple suivant montre comment retourner uniquement une partie d’une chaîne de caractères à partir d’une position de début donnée. Étant donné que l’argument de longueur n’est pas fourni, la longueur renvoie par défaut les caractères restants dans la chaîne.

SELECT SUBSTRING('123abc', 4) AS y;

Voici le jeu de résultats.

y
-----
abc

F. Utiliser SUBSTRING sans argument de longueur pour rechercher des pièces de remplacement dans l’inventaire AdventureWorks2022

USE AdventureWorks2022;
GO

SELECT [ProductDescriptionID],
       [Description],
       SUBSTRING([Description], LEN('Replacement') + 1) AS [Replacement-Part]
FROM [Production].[ProductDescription]
WHERE [Description] LIKE 'Replacement%';

Voici le jeu de résultats.

ProductDescriptionID	Descriptif	Replacement-Part
686	Roue de montagne de remplacement pour le pilote de niveau d’entrée.	roue de montagne pour le pilote de niveau d’entrée.
687	Roue de montagne de remplacement pour le pilote occasionnel à sérieux.	roue de montagne pour le pilote occasionnel à sérieux.
689	Roue avant de remplacement de la route pour cycliste de niveau d’entrée.	roue avant routière pour cycliste d’entrée de gamme.
867	Remplacement de la roue de montagne arrière pour le pilote de niveau d’entrée.	roue de montagne arrière pour le pilote de niveau d’entrée.
868	Remplacement de la roue de montagne arrière pour le pilote occasionnel à sérieux.	roue de montagne arrière pour le pilote occasionnel à sérieux.
870	Roue arrière de remplacement pour cycliste de niveau d’entrée.	roue arrière pour cycliste de niveau d’entrée.
1981	Roue de montagne de remplacement pour le pilote de niveau d’entrée.	roue de montagne pour le pilote de niveau d’entrée.
1987	Roue de montagne de remplacement pour le pilote occasionnel à sérieux.	roue de montagne pour le pilote occasionnel à sérieux.
1999	Roue arrière de la route de remplacement pour cycliste de niveau d’entrée.	roue arrière de la route pour cycliste de niveau d’entrée.

Partager via

SOUS-CHAÎNE (Transact-SQL)

Syntaxe

Les arguments

expression

démarrer

longueur

Types de retour

Notes

Caractères supplémentaires (paires de substitution)

Exemples

R. Utiliser SUBSTRING avec une chaîne de caractères

B. Utiliser SUBSTRING avec du texte, ntext et des données d’image

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

Chapitre C. Utiliser SUBSTRING avec une chaîne de caractères

D. Utiliser SUBSTRING avec NULL l’argument de longueur

E. Utiliser SUBSTRING avec un argument de longueur facultatif

F. Utiliser SUBSTRING sans argument de longueur pour rechercher des pièces de remplacement dans l’inventaire AdventureWorks2022

Contenu connexe

Commentaires

Ressources supplémentaires

D. Utiliser SUBSTRING avec `NULL` l’argument de longueur