Поделиться через

ПОДСТРОКА (Transact-SQL)

Область применения: SQL Server База данных SQL Azure Управляемый экземпляр SQL Azure конечной точке аналитики платформы Аналитики Azure Synapse Analytics (PDW)в Microsoft FabricХранилище в Microsoft Fabric

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

Соглашения о синтаксисе Transact-SQL

Синтаксис

Синтаксис для SQL Server.

SUBSTRING ( expression , start , length )

Синтаксис базы данных SQL Azure, Управляемый экземпляр SQL Azure, Azure Synapse Analytics, система платформы аналитики (PDW) и конечная точка аналитики SQL и хранилища в Microsoft Fabric.

SUBSTRING ( expression , start [ , length ] )

Аргументы

выражение

Символ, двоичный, текст, ntext или выражение изображения.

Начало

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

длина

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

Вы можете использовать подстроку с необязательным аргументом длины в Базе данных SQL Azure, Управляемом экземпляре SQL Azure, Azure Synapse Analytics, системе платформы аналитики (PDW) и конечной точке аналитики SQL в Microsoft Fabric. Однако если вы используете NULL для длины, SUBSTRING возвращается NULL. Проверьте E. Используйте SUBSTRING с необязательным аргументом длины , например.

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

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

Заданное выражение Возвращаемый тип
обугливать / Варчар / СМС Варчар
НЧАР / Нварчар / Текст Нварчар
двоичный / варбинарный / образ varbinary

Замечания

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

Выражение должно быть varchar(max) или varbinary(max), если начальная илидлина содержит значение, превышающее 2 147 483 647.

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

При использовании дополнительных параметров сортировки символов (SC) и начальное и длинное число каждой суррогатной пары в выражении в виде одного символа. Для получения дополнительной информации см. Сортировка и поддержка Юникода.

Примеры

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

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

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

Вот результирующий набор.

имя Начальное ТретийИЧетвертыйСимволы
master m st
tempdb t mp
model m de
msdb m db

Чтобы отобразить второй, третий и четвертый символы строковой константы abcdef, используйте следующий запрос.

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

Вот результирующий набор.

x
----------
bcd

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

Примечание.

Чтобы выполнить следующие примеры, необходимо установить базу данных pubs.

В приведенном ниже примере показано, как вернуть первые 10 символов из каждого столбца данных text и image в таблице pub_info базы данных pubs. Данные text возвращаются как varchar, а данные image — как varbinary.

USE pubs;
GO

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

В следующем примере показано влияние на SUBSTRING и 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 FOREIGN KEY
        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 AS pr
     INNER JOIN npub_info AS npr
         ON pr.pub_id = npr.pub_id
ORDER BY pr.pub_id ASC;

Примеры: Azure Synapse Analytics и система платформы аналитики (PDW)

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

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

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

Вот результирующий набор.

LastName             Initial
-------------------- -------
Barbariol            A
Barber               D
Barreto de Mattos    P

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

USE ssawPDW;

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

Вот результирующий набор.

x
-----
bcd

Д. Использование SUBSTRING с NULL аргументом длины

SELECT SUBSTRING('123abc', 4, NULL) AS [NULL length];

Вот результирующий набор.

NULL length
-----------
NULL

Е. Использование SUBSTRING с необязательным аргументом длины

Применимо к: База данных SQL Azure, Управляемый экземпляр SQL Azure, Azure Synapse Analytics, система платформы аналитики (PDW) и конечная точка аналитики SQL и хранилище и аналитика SQL в Microsoft Fabric

В следующем примере показано, как возвращать только часть символьной строки из заданной начальной позиции. Так как аргумент длины не указан, длина по умолчанию возвращает оставшиеся символы в строке.

SELECT SUBSTRING('123abc', 4) AS y;

Вот результирующий набор.

y
-----
abc

F. Использование SUBSTRING без аргумента длины для поиска замены частей в инвентаризации AdventureWorks2022

USE AdventureWorks2022;
GO

SELECT [ProductDescriptionID],
       [Description],
       SUBSTRING([Description], LEN('Replacement') + 1) AS [Replacement-Part]
FROM [Production].[ProductDescription]
WHERE [Description] LIKE 'Replacement%';

Вот результирующий набор.

ProductDescriptionID Описание Replacement-Part
686 Замена горного колеса для всадника начального уровня. горный колесо для всадника уровня входа.
687 Замена горных колес для случайного серьезного всадника. горное колесо для случайного серьезного всадника.
689 Замена дорожного колеса переднего колеса для велосипедиста уровня входа. дорожный передний колесо для велосипедиста уровня входа.
867 Замена заднего горного колеса для всадника уровня входа. задний горный колесо для всадника уровня входа.
868 Замена заднего горного колеса для случайного серьезного всадника. заднее горное колесо для случайного серьезного всадника.
870 Замена заднего колеса для велосипедиста уровня входа. заднее колесо для велосипедиста уровня входа.
1981 Замена горного колеса для всадника начального уровня. горный колесо для всадника уровня входа.
1987 Замена горных колес для случайного серьезного всадника. горное колесо для случайного серьезного всадника.
1999 Замена заднего колеса дороги для велосипедиста уровня входа. дорожный задний колесо для велосипедиста уровня входа.

Связанный контент