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

  • Статья

Применимо к: SQL Server Integration Runtime служб SSIS в Фабрика данных Azure

Возвращает символьное выражение, которое было реплицировано, заданное количество раз. Аргумент times должен выдавать целое число.

Примечание

Функция REPLICATE часто использует длинные строки, поэтому лучше ввести ограничение на длину выражения — 4 000 символов. Если результат вычисления выражения имеет тип данных служб Integration Services DT_WSTR или DT_STR, выражение будет усечено до 4000 символов. Если тип результата вложенного выражения — DT_STR или DT_WSTR, это выражение также будет усечено до 4000 символов, независимо от типа результата всего выражения. Последствия усечения могут быть корректно обработаны или могут вызвать предупреждение или ошибку. Дополнительные сведения см. в разделе Синтаксис (службы SSIS).

Синтаксис

  
REPLICATE(character_expression,times)

Аргументы

character_expression
Символьное выражение для репликации.

times
Целочисленное выражение, которое определяет, сколько раз character_expression будет реплицировано.

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

DT_WSTR

Remarks

Если times равно нулю, функция возвратит строку нулевой длины.

Если times является отрицательным числом, то функция возвратит ошибку.

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

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

Функция REPLICATE возвращает NULL, если значение любого из аргументов равно NULL.

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

Этот пример реплицирует строковый литерал три раза. Результат — «Mountain BikeMountain BikeMountain Bike».

REPLICATE("Mountain Bike", 3)

Этот пример реплицирует значения в столбце Name значением из переменной Times . Если Times равно 3 и Name равно «Touring Front Wheel», то результат будет — «Touring Front WheelTouring Front WheelTouring Front Wheel».

REPLICATE(Name, @Times)

Этот пример реплицирует значение в переменной Name значением из столбца Times . Times имеет нецелочисленный тип данных и выражение включает явное приведение к целочисленному типу данных. Если Name содержит «Helmet» и Times равно 2, то результат будет — «HelmetHelmet».

REPLICATE(@Name, (DT_I4(Times))

См. также:

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