Compartir a través de


REPLACE (expresión de SSIS)

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 utiliza con frecuencia cadenas largas y, por consiguiente, es más probable que incurra en el límite de 4.000 caracteres en la longitud de la expresión. Si el resultado de la evaluación de una expresión tiene el tipo de datos DT_WSTR o DT_STR de Integration Services, la expresión se truncará a 4.000 caracteres. Si el tipo de resultado de una subexpresión es DT_STR o DT_WSTR, dicha subexpresión se truncará también a 4.000 caracteres, independientemente del tipo de resultado de la expresión general. Las consecuencias del truncamiento pueden controlarse o pueden dar lugar a una advertencia o un error. Para obtener más información, vea 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

Comentarios

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 argumentos character_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. Otros tipos de datos deberán convertirse explícitamente al tipo de datos DT_WSTR. Para obtener más información, vea Cast (expresión de SSIS): conversión de tipos de datos de SSIS.

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

Ejemplos

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 entero y la expresión incluye la conversión de DaysToManufacture al tipo de datos DT_WSTR.

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