REPLICATE (expressão SSIS)

se aplica a:SQL Server SSIS Integration Runtime no Azure Data Factory

Retorna uma expressão de caractere que é replicada várias vezes. O vezes argumento deve ser avaliado para um inteiro.

Observação

A função REPLICATE usa frequentemente cadeias de caracteres longas e, portanto, é mais provável que incorra no limite de 4000 caracteres no comprimento da expressão. Se o resultado da avaliação de uma expressão tiver o tipo de dados do Integration Services DT_WSTR ou DT_STR, a expressão será truncada em 4000 caracteres. Se o tipo de resultado de uma subexpressão for DT_STR ou DT_WSTR, essa subexpressão também será truncada para 4000 caracteres, independentemente do tipo de resultado geral da expressão. As consequências do truncamento podem ser tratadas com elegância ou causar um aviso ou um erro. Para obter mais informações, consulte Sintaxe (SSIS).

Sintaxe

  
REPLICATE(character_expression,times)  

Argumentos

character_expression
É uma expressão de caractere a ser replicada.

vezes
É uma expressão inteira que especifica o número de vezes que character_expression é replicado.

Tipos de resultados

DT_WSTR

Comentários

Se vezes for zero, a função retornará uma cadeia de caracteres de comprimento zero.

Se vezes é um número negativo, a função retorna um erro.

O argumento vezes também pode usar variáveis e colunas.

REPLICATE funciona apenas com o tipo de dados DT_WSTR. Um argumento character_expression que é um literal de cadeia de caracteres ou uma coluna de dados com o tipo de dados DT_STR é implicitamente convertido para o tipo de dados DT_WSTR antes de REPLICATE executar sua operação. Outros tipos de dados devem ser explicitamente convertidos para o tipo de dados DT_WSTR. Para obter mais informações, consulte Tipos de dados do Integration Services e Cast (expressão SSIS).

REPLICATE retorna um resultado nulo se qualquer um dos argumentos for nulo.

Exemplos de expressões

Este exemplo replica um literal de cadeia de caracteres três vezes. O resultado do retorno é "Mountain BikeMountain BikeMountain Bike".

REPLICATE("Mountain Bike", 3)  

Este exemplo replica valores na coluna Name pelo valor na variável Times. Se Times for 3 e nome for Touring Front Wheel, o resultado de retorno será Touring Front WheelTouring Front WheelTouring Front Wheel.

REPLICATE(Name, @Times)  

Este exemplo replica o valor na variável Name pelo valor na coluna Times. Times tem um tipo de dados não inteiro e a expressão inclui uma conversão explícita para um tipo de dados inteiro. Se Name contiver Capacete e Times for 2, o resultado de retorno será "HelmetHelmet".

REPLICATE(@Name, (DT_I4(Times))  

Ver também

funções (expressão SSIS)