A função REGEXP_EXTRACT pesquisa a string source em busca de uma correspondência com a expressão regular pattern e retorna o conteúdo do grupo especificado por group_id.
Notas de uso
A função REGEXP_EXTRACT segue as especificações de expressão regular do Java para o Hive-compatible data type edition. Para o 1.0 e o 2.0 data type editions, ela segue as especificações do MaxCompute.
Sintaxe
STRING REGEXP_EXTRACT(STRING <source>, STRING <pattern>[, BIGINT <group_id>])Parâmetros
source: Obrigatório. Um valor do tipo STRING. Especifica a string a ser pesquisada.
pattern: Obrigatório. Uma constante ou expressão regular do tipo STRING. Especifica o padrão de correspondência. Para mais informações sobre como escrever expressões regulares, consulte Regular expression specifications.
-
group_id: Opcional. Um valor do tipo BIGINT. O valor deve ser maior ou igual a 0.
Se group_id não for especificado, o valor padrão será 1 e a função retornará o primeiro grupo correspondente.
Quando group_id for especificado, a função retornará o conteúdo do grupo correspondente group_id.
Com group_id igual a 0, a função retorna a substring que corresponde ao pattern inteiro.
Os dados são armazenados no formato UTF-8. O intervalo de código hexadecimal para caracteres chineses é [\\x{4e00},\\x{9fa5}].
Valor de retorno
A função retorna um valor do tipo STRING. As seguintes regras se aplicam:
-
Se pattern for uma string vazia, ou se pattern não contiver grupos de captura e group_id não for especificado, um erro será retornado.
NotaExecute
SET odps.sql.bigquery.compatible=true;para ativar o modo compatível com BigQuery. Se pattern não contiver grupos e group_id não for especificado, a função retorna a substring que corresponde ao pattern inteiro. Se group_id não for do tipo BIGINT ou for menor que 0, um erro será retornado.
Se source, pattern ou group_id for NULL, o retorno será NULL.
Funções relacionadas
REGEXP_EXTRACT é uma função de string. Para mais informações sobre outras funções de string, consulte String Functions Overview.