View a markdown version of this page

Função REPLACE - Amazon Redshift
SintaxeArgumentosTipo de retornoExemplos

O Amazon Redshift deixará de oferecer suporte ao uso de UDFs em Python após 30 de junho de 2026. Começaremos a aplicar essa alteração em fases. Consulte mais informações sobre os detalhes do fim da vida útil do Python e as opções de migração na publicação do blog publicada em 30 de junho de 2025.

Função REPLACE

Substitui todas as ocorrências de um conjunto de caracteres em uma string existente por outros caracteres especificados.

REPLACE é semelhante a Função TRANSLATE e Função REGEXP_REPLACE, exceto que TRANSLATE faz várias substituições de caractere único e REGEXP_REPLACE permite que você pesquise uma string quanto a um padrão de expressão regular, enquanto REPLACE substitui uma string inteira por outra string.

Sintaxe

REPLACE(string, old_chars, new_chars)

Argumentos

string

String CHAR ou VARCHAR a ser pesquisada

old_chars

A string CHAR ou VARCHAR a ser substituída.

new_chars

Nova string CHAR ou VARCHAR que substitui old_string.

Tipo de retorno

VARCHAR

Se old_chars ou new_chars for NULL, o retorno será NULL.

Exemplos

O exemplo a seguir usa dados da tabela CATEGORY do banco de dados de amostra TICKIT. Para obter mais informações, consulte Banco de dados de exemplo.

Para converter a string Shows em Theatre no campo CATGROUP, use o exemplo a seguir. 

SELECT catid, catgroup, REPLACE(catgroup, 'Shows', 'Theatre')
FROM category
ORDER BY 1,2,3;

+-------+----------+----------+
| catid | catgroup | replace  |
+-------+----------+----------+
|     1 | Sports   | Sports   |
|     2 | Sports   | Sports   |
|     3 | Sports   | Sports   |
|     4 | Sports   | Sports   |
|     5 | Sports   | Sports   |
|     6 | Shows    | Theatre  |
|     7 | Shows    | Theatre  |
|     8 | Shows    | Theatre  |
|     9 | Concerts | Concerts |
|    10 | Concerts | Concerts |
|    11 | Concerts | Concerts |
+-------+----------+----------+