REPLACE (SSIS)
Gibt einen Zeichenausdruck zurück, nachdem eine Zeichenfolge im Ausdruck durch eine andere Zeichenfolge oder durch eine leere Zeichenfolge ersetzt wurde.
.gif "Hinweis") Hinweis |
|---|
Die REPLACE-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
REPLACE(character_expression,searchstring,replacementstring)
Argumente
character_expression
Ein gültiger Zeichenausdruck, den die Funktion durchsucht.searchstring
Ein gültiger Zeichenausdruck, nach dem die Funktion sucht.replacementstring
Ein gültiger Zeichenausdruck, der den zu ersetzenden Ausdruck darstellt.
Ergebnistypen
DT_WSTR
Hinweise
Die Länge von searchstring darf nicht Null sein.
Die Länge von replacementstring darf Null sein.
Für die Argumente searchstring und replacementstring sind Variablen und Spalten möglich.
REPLACE kann nur mit dem DT_WSTR-Datentyp verwendet werden. Die Argumente character_expression1, character_expression2, und character_expression3, bei denen es sich um Zeichenfolgenliterale oder Datenspalten mit dem DT_STR-Datentyp handelt, werden implizit in den DT_WSTR-Datentyp umgewandelt, bevor REPLACE ausgeführt wird. Andere Datentypen müssen explizit in den DT_WSTR-Datentyp umgewandelt werden. Weitere Informationen finden Sie unter CAST (SSIS).
REPLACE gibt ein NULL-Ergebnis zurück, wenn eines der Argumente NULL ist.
Beispiele
In diesem Beispiel wird ein Zeichenfolgenliteral verwendet. Als Ergebnis wird "All Terrain Bike" zurückgegeben.
REPLACE("Mountain Bike", "Mountain","All Terrain")
In diesem Beispiel wird die Zeichenfolge "Bike" aus der Product-Spalte entfernt.
REPLACE(Product, "Bike","")
In diesem Beispiel werden Werte in der DaysToManufacture-Spalte ersetzt. Die Spalte weist einen integer-Datentyp auf, und der Ausdruck enthält die Umwandlung von DaysToManufacture in den DT_WSTR-Datentyp.
REPLACE((DT_WSTR,8)DaysToManufacture,"6","5")