Substitui todas as substrings em uma string que correspondem a uma expressão regular e retorna o resultado como uma nova string.
REGEXP_REPLACE(str, pattern, replacement) retorna um novo VARCHAR a partir de str com cada substring correspondente à expressão regular em pattern substituída por replacement.
Limitações
Compatível apenas com o Realtime Compute for Apache Flink que usa Ververica Runtime (VVR) 3.0.0 ou posterior.
Sintaxe
VARCHAR REGEXP_REPLACE(VARCHAR str, VARCHAR pattern, VARCHAR replacement)
Parâmetros de entrada
|
Parâmetro |
Tipo de dados |
Descrição |
|
|
VARCHAR |
String de origem da busca. |
|
|
VARCHAR |
Padrão de expressão regular para correspondência. |
|
|
VARCHAR |
String que substitui cada correspondência. |
Retorna NULL se qualquer parâmetro de entrada for NULL ou se a expressão regular for inválida.
Notas de uso
Tanto pattern quanto replacement seguem a sintaxe do Java Pattern.
Exemplos
Os exemplos abaixo usam a tabela T1 como fonte de dados:
T1
|
str1 (VARCHAR) |
pattern1 (VARCHAR) |
replace1 (VARCHAR) |
|
|
|
(string vazia) |
|
(string vazia) |
|
(string vazia) |
|
|
(string vazia) |
|
|
|
|
|
|
|
|
|
Consulta
SELECT REGEXP_REPLACE(str1, pattern1, replace1) AS `result`
FROM T1;
Resultados
|
result (VARCHAR) |
Explicação |
|
|
Substitui todos os hífens por uma string vazia. |
|
(string vazia) |
A string de entrada está vazia; não há nada para substituir. |
|
|
Um padrão vazio corresponde a cada posição entre caracteres e insere |
|
NULL |
|
|
|
|