SUBSTRING (выражение SSIS)

Область применения:SQL Server среда выполнения интеграции SSIS в Фабрика данных Azure

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

Синтаксис

  
SUBSTRING(character_expression, position, length)  

Аргументы

character_expression
Символьное выражение, из которого извлекаются символы.

положение
Является целым числом, указывающим, где начинается подстрока.

length
Является целым числом, указывающим длину подстроки в виде числа символов.

Типы результата

DT_WSTR

Замечания

SUBSTRING использует однобазовый индекс. Если параметр position имеет значение 1, то подстрока начинается с первого символа в значении параметра character_expression.

Функция SUBSTRING работает только с типом данных DT_WSTR. Аргумент character_expression , являющийся строковым литералом или столбцом данных с типом данных DT_STR, неявно приведен к типу данных DT_WSTR до выполнения функции SUBSTRING. Прочие типы данных должны быть явно приведены к типу данных DT_WSTR. Дополнительные сведения см. в разделах Типы данных Integration Services и Приведение (выражение SSIS).

Функция SUBSTRING возвращает нулевой результат при нулевом аргументе.

Все аргументы в выражении могут использовать переменные и столбцы.

Аргумент length может превышать длину строки. В этом случае функция возвращает остаток строки.

Примеры выражений

Этот пример возвращает два символа из строкового литерала, начиная с 4-го символа. Возвращаемый результат — «ph».

SUBSTRING("elephant",4,2)  

Этот пример возвращает остаток строкового литерала, начиная с четвёртого символа. Возвращаемый результат — «phant». Превышение аргументом length размера строки не является ошибкой.

SUBSTRING ("elephant",4,50)  

Этот пример возвращает первую букву из столбца MiddleName .

SUBSTRING(MiddleName,1,1)  

Этот пример использует переменные в аргументах position и length . Если Start равно 1, и Length равно 5, то функция возвращает первые пять символов столбца Name .

SUBSTRING(Name,@Start,@Length)  

Этот пример возвращает четыре последних символа переменной PostalCode , начиная с шестого символа.

SUBSTRING (@PostalCode,6,4)  

Этот пример возвращает строку нулевой длины из строкового литерала.

SUBSTRING ("Redmond",4,0)