Freigeben über


ERSETZEN (SSIS-Ausdruck)

Gibt einen Zeichenausdruck zurück, nachdem eine Zeichenfolge im Ausdruck durch eine andere Zeichenfolge oder durch eine leere Zeichenfolge ersetzt wurde.

HinweisHinweis

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-Ausdruck): Konvertieren von SSIS-Datentypen.

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")