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 или 0. Если значение start_expression больше количества символов в выражении значения, то возвращается выражение с нулевой длиной.

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

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

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

Заданное выражение	Возвращаемый тип
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.

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

Примеры

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

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

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

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

LastName Initial

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

Barley R

Barlow B

(Обработано строк: 2)

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

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

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

x

----------

bcd

(Обработано строк: 1)

Б. Использование 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)

Следующий пример показывает влияние функции SUBSTRING на данные типа text и ntext. Во-первых, пример создает новую таблицу в базе данных pubs под именем npub_info. Во-вторых, пример создает столбец pr_info в таблице npub_info из первых 80 символов столбца pub_info.pr_info и добавляет u в качестве первого символа. Наконец, с помощью предложения 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');
INSERT npub_info values('0877', N'üThis is sample text data for Binnet & Hardley, publisher 0877 in the pubs databa');
INSERT npub_info values('1389', N'üThis is sample text data for Algodata Infosystems, publisher 1389 in the pubs da');
INSERT npub_info values('9952', N'üThis is sample text data for Scootney Books, publisher 9952 in the pubs database');
INSERT npub_info values('1622', N'üThis is sample text data for Five Lakes Publishing, publisher 1622 in the pubs d');
INSERT npub_info values('1756', N'üThis is sample text data for Ramona Publishers, publisher 1756 in the pubs datab');
INSERT npub_info values('9901', N'üThis is sample text data for GGG&G, publisher 9901 in the pubs database. GGG&G i');
INSERT npub_info values('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)