SUBSTRING (Transact-SQL)

Возвращает фрагмент символьного, двоичного, текстового или графического выражения. Дополнительные сведения о допустимых типах данных SQL Server, которые могут быть использованы в этой функции, см. в разделе Типы данных (Transact-SQL).

Соглашения о синтаксическом обозначении в Transact-SQL

Синтаксис

SUBSTRING (value_expression ,start_expression ,length_expression )

Аргументы

• value_expression
  Выражение типа character, binary, text, ntext или image.

• start_expression
  Целое число или выражение типа bigint, указывающее начальную позицию возвращаемых символов. Если аргумент start_expression имеет значение меньше 1, то возвращаемое выражение начинается с первого символа, который указан в аргументе value_expression. В этом случае количество возвращаемых символов является наибольшим значением либо суммы start_expression + length_expression – 1, либо 0. Если значение start_expression превышает количество символов в выражении значения, то возвращается выражение нулевой длины.

• length_expression
  Положительное целое число или выражение типа bigint, указывающее количество символов выражения value_expression, которое будет возвращено. Если значение length_expression отрицательно, формируется ошибка и выполнение инструкции прерывается. Если сумма start_expression и length_expression больше количества символов в value_expression, то возвращается целочисленное выражение значения, начинающегося со значения start_expression.

Возвращаемые типы

Возвращает символьные данные, если expression имеет один из поддерживаемых символьных типов данных. Возвращает двоичные данные, если expression имеет один из поддерживаемых binary типов данных. Возвращенная строка имеет тот же самый тип, как и заданное выражение. Исключения указаны в таблице.

Заданное выражение	Возвращаемый тип
char/varchar/text	varchar
nchar/nvarchar/ntext	nvarchar
binary/varbinary/image	varbinary

Замечания

Значения start_expression и length_expression должны быть указаны в виде количества символов для типов данных ntext, char или varchar и байтов для типов данных text, image, binary или varbinary.

Значение value_expression должно иметь тип varchar(max) или varbinary(max) , если аргумент start_expression или length_expression содержит значение больше 2147483647.

Примечание
Уровни совместимости могут влиять на возвращаемые значения. Дополнительные сведения об уровнях совместимости см. в разделе Уровень совместимости инструкции ALTER DATABASE (Transact-SQL).

Примеры

А. Использование SUBSTRING с символьной строкой

Следующий пример показывает, как получить часть символьной строки. Из таблицы Person данный запрос возвращает фамилию в одном столбце и первую букву имени в другом.

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

Ниже приводится результирующий набор.

LastName       Initial

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

Barley         R

Barlow         B

(2 row(s) affected)

Далее показано, как можно вывести второй, третий и четвертый символ строковой константы abcdef.

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

Ниже приводится результирующий набор.

x

----------

bcd

(1 row(s) affected)

Б. Использование SUBSTRING с данными типа text, ntext или с изображением

Примечание
Для выполнения следующих примеров необходимо установить базу данных pubs. Дополнительные сведения об установке базы данных pubs см. в разделе Загрузка образцов баз данных Northwind и pubs.

В следующем примере показано, как вернуть первые 10 символов из каждого из столбцов данных text и image в таблице pub_info в базе данных pubs. Данные text возвращаются как varchar, а данные image — как 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';

Ниже приводится результирующий набор.

pub_id logo pr_info

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

1756 0x474946383961E3002500 This is sa

(1 row(s) affected)

Следующий пример показывает влияние функции SUBSTRING на данные типа text и ntext. Во-первых, пример создает новую таблицу в базе данных pubs под именем npub_info. Во-вторых, пример создает столбец pr_info в таблице npub_info из первых 80 символов столбца pub_info.pr_info и добавляет ü в качестве первого символа. Наконец, с помощью предложения INNER JOIN получает все идентификационные номера издателей, а также обработанные функцией SUBSTRING значения столбцов типа text и 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;

См. также

Справочник

Строковые функции (Transact-SQL)