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)