REPLICATE (SSIS)
Gibt einen Zeichenausdruck zurück, der mehrfach repliziert wird. Das times-Argument muss zu einer ganzen Zahl ausgewertet werden.
.gif "Hinweis") Hinweis |
|---|
Die REPLICATE-Funktion verwendet häufig lange Zeichenfolgen und wird daher eher Probleme mit der auf 4.000 Zeichen beschränkten Länge von Ausdrücken verursachen. Hat das Auswertungsergebnis eines Ausdrucks den Integration Services-Datentyp DT_WSTR oder DT_STR, wird der Ausdruck nach 4.000 Zeichen abgeschnitten. Ist der Ergebnistyp eines Unterausdrucks DT_STR oder DT_WSTR, wird dieser Unterausdruck unabhängig vom Ergebnistyp des Gesamtausdrucks ebenfalls nach 4.000 Zeichen abgeschnitten. Die Folgen der Kürzung können unauffällig behandelt werden oder eine Warnung oder einen Fehler verursachen. Weitere Informationen finden Sie unter Syntax (SSIS). |
Syntax
REPLICATE(character_expression,times)
Argumente
character_expression
Ein Zeichenausdruck, der repliziert werden soll.times
Eine ganzzahliger Ausdruck, der angibt, wie oft character_expression repliziert wird.
Ergebnistypen
DT_WSTR
Hinweise
Falls times gleich Null ist, gibt die Funktion eine leere Zeichenfolge zurück.
Falls times eine negative Zahl ist, gibt die Funktion einen Fehler zurück.
Für das times-Argument sind auch Variablen und Spalten möglich.
REPLICATE kann nur mit dem DT_WSTR-Datentyp verwendet werden. Ein character_expression -Argument, das ein Zeichenfolgenliteral oder eine Datenspalte mit dem DT_STR-Datentyp ist, wird implizit in den DT_WSTR-Datentyp umgewandelt, bevor REPLICATE ausgeführt wird. Andere Datentypen müssen explizit in den DT_WSTR-Datentyp umgewandelt werden. Weitere Informationen finden Sie unter SQL Server Integration Services-Datentypen und CAST (SSIS).
REPLICATE gibt ein NULL-Ergebnis zurück, wenn eines der Argumente NULL ist.
Beispiele
In diesem Beispiel wird ein Zeichenfolgenliteral dreimal repliziert. Als Ergebnis wird "Mountain BikeMountain BikeMountain Bike" zurückgegeben.
REPLICATE("Mountain Bike", 3)
In diesem Beispiel werden Werte in der Name-Spalte mit dem Wert in der Times-Variablen repliziert. Falls Times 3 und Name Touring Front Wheel ist, wird als Ergebnis Touring Front WheelTouring Front WheelTouring Front Wheel zurückgegeben.
REPLICATE(Name, @Times)
In diesem Beispiel wird der Wert in der Name-Variablen mit dem Wert in der Times-Spalte repliziert. Times weist einen noninteger-Datentyp auf, und der Ausdruck schließt eine explizite Umwandlung in einen integer-Datentyp. Falls Name Helmet einschließt und Times 2 ist, wird als Ergebnis "HelmetHelmet" zurückgegeben.
REPLICATE(@Name, (DT_I4(Times))