REPLACE (SSIS)

Restituisce un'espressione di caratteri dopo aver sostituito una stringa di caratteri nell'espressione con un'altra stringa di caratteri o una stringa vuota.

[!NOTA]

La funzione REPLACE utilizza spesso stringhe lunghe ed è pertanto più facile che un'espressione superi il limite di 4000 caratteri di lunghezza. Se il risultato della valutazione di un'espressione ha il tipo di dati Integration Services DT_WSTR o DT_STR, l'espressione verrà troncata a 4000 caratteri. Se il tipo di risultato di una sottoespressione è DT_STR o DT_WSTR, probabilmente la sottoespressione verrà troncata a 4000 caratteri, indipendentemente dal tipo di risultato dell'espressione globale. Le conseguenze del troncamento possono essere gestite normalmente oppure generare un avviso o un errore. Per ulteriori informazioni, vedere Sintassi (SSIS).

Sintassi

REPLACE(character_expression,searchstring,replacementstring)

Argomenti

  • character_expression
    Espressione di caratteri valida in cui la funzione esegue la ricerca.

  • searchstring
    Espressione di caratteri valida che la funzione tenta di individuare.

  • replacementstring
    Espressione di caratteri valida che costituisce l'espressione da sostituire.

Tipi restituiti

DT_WSTR

Osservazioni

La lunghezza di searchstring deve essere diversa da zero.

La lunghezza di replacementstring può essere zero.

Gli argomenti searchstring e replacementstring possono utilizzare variabili e colonne.

È possibile utilizzare REPLACE solo con il tipo di dati DT_WSTR. Per gli argomenti character_expression1, character_expression2, e character_expression3 costituiti da valori letterali stringa o da colonne di dati con tipo di dati DT_STR, prima di eseguire l'operazione della funzione REPLACE viene eseguito il cast implicito al tipo di dati DT_WSTR. Per gli altri tipi di dati è necessario il cast esplicito al tipo di dati DT_WSTR. Per ulteriori informazioni, vedere Cast (SSIS).

Se un argomento qualsiasi è Null, REPLACE restituirà Null.

Esempi

In questo esempio viene utilizzato un valore letterale stringa. Il risultato restituito è "All Terrain Bike".

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

In questo esempio viene rimossa la stringa "Bike" dalla colonna Product.

REPLACE(Product, "Bike","")

In questo esempio vengono sostituiti alcuni valori nella colonna DaysToManufacture. La colonna ha tipo di dati integer e l'espressione include il cast di DaysToManufacture al tipo di dati DT_WSTR.

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

Vedere anche

Riferimento

Altre risorse