SUBSTRING (выражение служб SSIS)

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

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

Синтаксис

  
SUBSTRING(character_expression, position, length)  

Аргументы

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

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

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)  

См. также

Функции (выражение служб SSIS)