REPLICATE (espressione SSIS)
Viene restituita un'espressione di caratteri ripetuta per il numero di volte specificato. L'argomento numero di volte deve restituire un Integer.
Nota
La funzione REPLICATE utilizza spesso stringhe lunghe e pertanto è più facile che un'espressione superi il limite di 4000 caratteri di lunghezza. Se il risultato della valutazione di un'espressione ha il tipo di dati Integration Services DT_WSTR o DT_STR, l'espressione verrà troncata a 4000 caratteri. Se il tipo di risultato di una sottoespressione è DT_STR o DT_WSTR, probabilmente la sottoespressione verrà troncata a 4000 caratteri, indipendentemente dal tipo di risultato dell'espressione globale. Le conseguenze del troncamento possono essere gestite normalmente oppure generare un avviso o un errore. Per altre informazioni, vedere Sintassi (SSIS).
Sintassi
REPLICATE(character_expression,times)
Argomenti
character_expression
Espressione di caratteri da replicare.
numero di volte
Espressione Integer che specifica il numero di volte in cui character_expression viene replicata.
Tipi restituiti
DT_WSTR
Osservazioni
Se il numero di volte ha valore zero, la funzione restituirà una stringa di lunghezza zero.
Se il numero di volte è un numero negativo, la funzione restituirà un errore.
L'argomento numero di volte può usare anche variabili e colonne.
È possibile utilizzare REPLICATE solo con il tipo di dati DT_WSTR. Se l'argomento character_expression è un valore letterale stringa o una colonna di dati con tipo di dati DT_STR, prima di eseguire l'operazione prevista da REPLICATE verrà eseguito il cast implicito al tipo di dati DT_WSTR. Per gli altri tipi di dati è necessario il cast esplicito al tipo di dati DT_WSTR. Per altre informazioni, vedere Tipi di dati di Integration Services e Cast (espressione SSIS).
Se l'argomento è Null, REPLICATE restituirà Null.
Esempi di espressione
In questo esempio un valore letterale stringa viene replicato tre volte. Il risultato restituito è "Mountain BikeMountain BikeMountain Bike".
REPLICATE("Mountain Bike", 3)
In questo esempio i valori nella colonna Nome vengono replicati per il numero di volte indicato dal valore della variabile Numero di volte . Se Numero di volte ha valore 3 e Nome contiene Touring Front Wheel, il risultato restituito sarà Touring Front WheelTouring Front WheelTouring Front Wheel.
REPLICATE(Name, @Times)
In questo esempio i valori nella variabile Nome vengono replicati per il numero di volte indicato dal valore nella colonna Numero di volte . La variabileNome ha un tipo di dati diverso da Integer e l'espressione include un cast esplicito a un tipo di dati Integer. Se Nome contiene il testo Helmet e Numero di volte ha valore 2, il risultato restituito sarà "HelmetHelmet".
REPLICATE(@Name, (DT_I4(Times))