SUBSTRING (Transact-SQL)

Возвращает часть символьного, двоичного, текстового или графического выражения в SQL Server.

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

Синтаксис

SUBSTRING ( expression ,start , length )

Аргументы

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

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

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

Типы возвращаемых данных

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

Замечания

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

Аргумент expression должен иметь тип varchar(max) или varbinary(max) , если аргумент start или length содержит значение, превышающее 2 147 483 647.

Дополнительные символы (суррогатные пары)

При использовании параметров сортировки дополнительных символов (SC) и start и length обрабатывают каждую суррогатную пару в expression как один символ. Дополнительные сведения см. в разделе Поддержка параметров сортировки и Юникода.

Примеры

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

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

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 или image

В следующем примере показано, как возвращать первые 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)