REPLACE (Expressão SSIS)
se aplica a:
SQL Server SSIS Integration Runtime no Azure Data Factory
Retorna uma expressão de caractere depois de substituir uma cadeia de caracteres dentro da expressão por uma cadeia de caracteres diferente ou uma cadeia de caracteres vazia.
Observação
A função REPLACE usa frequentemente cadeias de caracteres longas. As consequências do truncamento podem ser tratadas com elegância ou causar um aviso ou um erro. Para obter mais informações, consulte Sintaxe (SSIS).
Sintaxe
REPLACE(character_expression,searchstring,replacementstring)
Argumentos
character_expression
É uma expressão de caractere válida que a função pesquisa.
searchstring
É uma expressão de caractere válida que a função tenta localizar.
substitutostring
É uma expressão de caractere válida que é a expressão de substituição.
Tipos de resultados
DT_WSTR
Comentários
O comprimento de searchstring não deve ser zero.
O comprimento de de substituição pode ser zero.
Os argumentos searchstring e replacementstring podem usar variáveis e colunas.
REPLACE funciona apenas com o tipo de dados DT_WSTR. character_expression1, character_expression2, e character_expression3 argumentos que são literais de cadeia de caracteres ou colunas de dados com o tipo de dados DT_STR são implicitamente convertidos para o tipo de dados DT_WSTR antes de REPLACE executar sua operação. Outros tipos de dados devem ser explicitamente convertidos para o tipo de dados DT_WSTR. Para obter mais informações, consulte Cast (Expressão SSIS).
REPLACE retorna um resultado nulo se qualquer argumento for nulo.
Exemplos de expressões
Este exemplo usa um literal de cadeia de caracteres. O resultado do retorno é "All Terrain Bike".
REPLACE("Mountain Bike", "Mountain","All Terrain")
Este exemplo remove a cadeia de caracteres "Bike" da coluna Product.
REPLACE(Product, "Bike","")
Este exemplo substitui valores na coluna DaysToManufacturing. A coluna tem um tipo de dados inteiro e a expressão inclui a conversão DaysToManufacture para o tipo de dados DT_WSTR.
REPLACE((DT_WSTR,8)DaysToManufacture,"6","5")