Share via


REPLACE (expresión de SSIS)

Se aplica a:SQL Server SSIS Integration Runtime en Azure Data Factory

Devuelve una expresión de caracteres tras reemplazar una cadena de caracteres dentro de la expresión por otra cadena de caracteres diferente o por la cadena vacía.

Nota

La función REPLACE usa con frecuencia cadenas largas. Las consecuencias del truncamiento pueden controlarse o pueden dar lugar a una advertencia o un error. Para obtener más información, consulte Sintaxis (SSIS).

Sintaxis

  
REPLACE(character_expression,searchstring,replacementstring)  

Argumentos

character_expression
Expresión de caracteres válida que busca la función.

searchstring
Expresión de caracteres válida que intenta encontrar la función.

replacementstring
Expresión de caracteres válida que se usa como expresión de reemplazo.

Tipos de resultado

DT_WSTR

Observaciones

La longitud de searchstring no debe ser cero.

La longitud de replacementstring puede ser cero.

Los argumentos searchstring y replacementstring pueden utilizar variables y columnas.

REPLACE solo funciona con el tipo de datos DT_WSTR. Los argumentoscharacter_expression1, character_expression2 y character_expression3 que son literales de cadena o columnas de datos con el tipo de datos DT_STR se convierten implícitamente al tipo de datos DT_WSTR antes de que REPLACE realice su operación. Los otros tipos de datos deben convertirse explícitamente al tipo de datos DT_WSTR. Para más información, vea Conversión (expresión de SSIS).

REPLACE devuelve un resultado NULL si alguno de los argumentos es NULL.

Ejemplos de expresiones

Este ejemplo usa un literal de cadena. El resultado devuelto es "All Terrain Bike".

REPLACE("Mountain Bike", "Mountain","All Terrain")  

Este ejemplo quita la cadena "Bike" de la columna Product .

REPLACE(Product, "Bike","")  

Este ejemplo reemplaza los valores de la columna DaysToManufacture . La columna tiene un tipo de datos Integer y en la expresión se incluye la conversión de DaysToManufacture al tipo de datos DT_WSTR.

REPLACE((DT_WSTR,8)DaysToManufacture,"6","5")  

Vea también

SUBSTRING (expresión de SSIS)
Funciones (expresión de SSIS)