SUBSTRING (Transact-SQL)

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

Conventions de la syntaxe Transact-SQL

Syntaxe

SUBSTRING ( expression ,start , length )

Arguments

• expression
  Expression character, binary, text, ntext ou image.

• start
  Entier ou expression bigint qui spécifie où les caractères retournés commencent. Si start est inférieur à 1, l'expression retournée commence au premier caractère spécifié dans expression. Dans ce cas, le nombre de caractères retourné correspond à la valeur la plus grande de la somme start + length -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.

• length
  Entier positif ou expression bigint qui spécifie le nombre de caractères de expression à retourner. Si length est négatif, une erreur est générée et l'instruction est terminé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.

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 de type binaire 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 :

Notes

Les valeurs de start et length doivent être spécifiées en nombre de caractères pour ntext, char, ou en types de données et octets varchar pour text, image, binary, ou en types de données varbinary.

L'expression doit être de type varchar(max) ou varbinary(max) lorsque start ou length contient une valeur supérieure à 2 147 483 647.

Caractères supplémentaires (paires de substitution)

Lors de l'utilisation des classements SC, start et length comptent chaque paire de substitution dans expression comme un caractère unique. Pour plus d'informations, consultez Prise en charge d'Unicode et du classement.

Exemples

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 table Person, cette requête retourne les noms de famille dans une colonne avec seulement la première initiale des prénoms dans la seconde colonne.

USE AdventureWorks2012;
GO
SELECT LastName, SUBSTRING(FirstName, 1, 1) AS Initial
FROM Person.Person
WHERE LastName like 'Barl%'
ORDER BY LastName;

Voici l'ensemble des résultats.

LastName      Initial

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

Barley        R

Barlow        B

(2 row(s) affected)

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

[!REMARQUE]

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 renvoyées au format varchar et les données image sont renvoyées au format 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 illustre l'effet de SUBSTRING sur les données text 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'information 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
    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;

Voir aussi

Référence

Fonctions de chaîne (Transact-SQL)