• Artigo

REPLACE (expressão SSIS)

Retorna uma expressão de caractere depois de substituir uma cadeia de caracteres na expressão por uma cadeia diferente ou vazia.

ObservaçãoObservação

A função REPLACE usa com frequência cadeias longas e, portanto, é mais provável de incorrer o limite de 4.000 caracteres no tamanho da expressão. Se o resultado da avaliação de uma expressão tiver o tipo de dados DT_WSTR ou DT_STR do Integration Services, a expressão truncará em 4.000 caracteres. Se o tipo de resultado de uma subexpressão for DT_STR ou DT_WSTR, essa subexpressão será truncada em 4.000 caracteres, independentemente do tipo de resultado da expressão geral. As consequências do truncamento podem ser controladas normalmente ou podem causar uma advertência 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.

  • replacementstring
    É uma expressão de caractere válida que é a expressão de substituição.

Tipos de resultado

DT_WSTR

Comentários

O comprimento de searchstring não deve ser nenhum zero.

O comprimento de replacementstring pode ser zero.

Os argumentos searchstring e replacementstring também podem usar variáveis e colunas.

REPLACE funciona apenas com o tipo de dados Dt_WSTR. Os argumentos character_expression1, character_expression2, e character_expression3, literais de cadeia de caracteres ou uma coluna 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): Converter tipos de dados SSIS.

REPLACE retornará um resultado nulo se qualquer argumento for nulo.

Exemplos

Este exemplo usa um literal de cadeia de caracteres. O resultado de retorno é “Toda Bicicleta de Terreno”.

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

Este exemplo remove a cadeia de caracteres "Bicicleta" da coluna Product .

REPLACE(Product, "Bike","")

Este exemplo substitui valores na coluna DaysToManufacture. A coluna tem um tipo de dados inteiro e a expressão inclui conversão de DaysToManufacture para o tipo de dados DT_WSTR.

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