# REPLACE

> Função REPLACE no StackQL: substituir cada ocorrência de uma substring dentro de uma string por outra string.

Source: https://stackql.io/pt-br/language-spec/functions/string/replace

Retorna uma string formada pela substituição de cada ocorrência de outra string por uma parte de uma string.

Veja também:  
[[` SELECT `]](/language-spec/select) 

* * * 

## Sintaxe

```sql
SELECT REPLACE(character_expression, pattern, replacement) FROM <multipartIdentifier>;
```

## Argumentos

__*character_expression*__  
Uma string literal ou coluna de string na qual você deseja fazer a substituição.

__*pattern*__  
A substring a ser encontrada na string original.

> Se *pattern* for uma string vazia ou não for encontrado em *character_expression*, a função retorna *character_expression* sem alterações. 

__*replacement*__  
A string de substituição.

> Se *replacement* não for inicialmente uma string, ele é convertido em uma string UTF-8 antes do processamento.

> As comparações usam a sequência de ordenação `BINARY`.

## Valor(es) retornado(s)
Retorna uma string.

* * *

## Exemplos

### Substituir um padrão de string em uma coluna

```sql
SELECT replace(name, 'prd', 'production') AS replacement_string
FROM google.compute.instances 
WHERE project = 'stackql-demo' 
AND zone = 'australia-southeast1-a';
```

Para obter mais informações, consulte [https://www.sqlite.org/lang_corefunc.html#replace](https://www.sqlite.org/lang_corefunc.html#replace)
