REPLICATE (службы SSIS)
Возвращает символьное выражение, которое было реплицировано, заданное количество раз. Аргумент times должен выдавать целое число.
.gif "Примечание") Примечание |
|---|
Функция 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
Замечания
Если times равно нулю, функция возвратит строку нулевой длины.
Если times является отрицательным числом, то функция возвратит ошибку.
Аргумент times также может использовать переменные и столбцы.
Функция REPLICATE работает только с типом данных DT_WSTR. До выполнения функции REPLICATE аргумент character_expression , являющийся строковым литералом или столбцом с типом данных DT_STR, должен быть явно приведен к типу данных DT_WSTR. Прочие типы данных должны быть явно приведены к типу данных DT_WSTR. Дополнительные сведения см. в разделах Типы данных служб Integration Services и Приведение (службы SSIS).
Функция 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))