SUBSTRING (Transact-SQL)

 

CETTE RUBRIQUE S’APPLIQUE À : ouiSQL Server (à partir de la version 2008)ouiAzure SQL DatabaseouiAzure SQL Data WarehouseouiParallel Data Warehouse

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

Topic link icon Conventions de la syntaxe Transact-SQL

-- Syntax for SQL Server, Azure SQL Database, Azure SQL Data Warehouse, Parallel Data Warehouse  
  
SUBSTRING ( expression ,start , length )  

expression
Est une caractère, binaire, texte, ntext, ou imageexpression.

Démarrer
Est un nombre entier ou bigint expression qui spécifie où les caractères renvoyés commencent. (La numérotation est 1 en fonction, cela signifie que le premier caractère de l’expression est 1). Si Démarrer est inférieur à 1, l’expression retournée commence au premier caractère qui est spécifié dans expression. Dans ce cas, le nombre de caractères renvoyés est la plus grande valeur de la somme de Démarrer + longueur- 1 ou 0. Si Démarrer est supérieur au nombre de caractères dans l’expression de valeur, une expression de longueur nulle est retournée.

longueur
Est un entier positif ou bigint expression qui spécifie le nombre de caractères de la expression sera retourné. Si longueur est négatif, une erreur est générée et l’instruction est terminée. Si la somme de Démarrer et longueur est supérieur au nombre de caractères dans expression, l’expression de valeur entier commençant à Démarrer est retourné.

Données de type caractère si expression est un des types de données caractères pris en charge. Retourne des données binaires si expression est une des prises en charge binaire des types de données. 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éeType de retour
char/varchar/textevarchar
NCHAR/nvarchar/ntextnvarchar
binaire/varbinary/imagevarbinary

Les valeurs de Démarrer et longueur doit être spécifié en nombre de caractères pour ntext, char, ou varchar des types de données et octets pour texte, image, binaire, ou varbinary des types de données.

Le expression doit être varchar (max) ou varbinary (max) lorsque le Démarrer ou longueur contient une valeur supérieure à 2147483647.

Lors de l’utilisation de classements de caractères supplémentaires (SC), les deux Démarrer et longueur comptent chaque paire de substitution expression comme un caractère unique. Pour plus d’informations, consultez Collation and Unicode Support.

A. Utilisation de 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 sys.databases table, cette requête renvoie le système de noms de base de données dans la première colonne, la première lettre de la base de données dans la deuxième colonne et les troisièmes et quatrième caractères dans la dernière colonne.

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

Voici l'ensemble des résultats.

nameInitialThirdAndFourthCharacters
mastermSt
tempdbtPack d’administration
modelmde
msdbmbase de données

Voici comment afficher les deuxième, troisième et quatrième caractères de la constante de chaîne abcdef :

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

Voici l'ensemble des résultats.

x

----------

bcd

(1 row(s) affected)

B. Utilisation de SUBSTRING avec des données text, ntext et image

System_CAPS_ICON_note.jpg Remarque


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

L’exemple suivant montre comment retourner les 10 premiers caractères de chaque un texte et image colonne de données dans le pub_info table de la pubs base de données. texte données sont retournées en tant que varchar, et image données sont retournées en tant que 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 l'ensemble des résultats.

pub_id logo pr_info

------ ---------------------- ----------

1756 0x474946383961E3002500 This is sa

(1 row(s) affected)

L’exemple suivant montre l’effet de SUBSTRING sur les deux texte et ntext données. 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. Enfin, un INNER JOIN récupère tous les numéros d’identification de serveur de publication et la SUBSTRING des deux la texte et ntext colonnes contenant les informations de serveur de publication.

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;  

C. Utilisation de 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 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.

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

Voici l'ensemble des résultats.

LastName Initial

-------------------- -------

Barbariol A

Barber D

Barreto de Mattos P

L’exemple suivant montre comment retourner les deuxième, troisièmes et quatrième caractères de la constante de chaîne abcdef.

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

Voici l'ensemble des résultats.

x

-----

bcd

Fonctions de chaîne &#40 ; Transact-SQL &#41 ;

Ajouts de la communauté

AJOUTER
Afficher: