Função regexp_substr
Aplica-se a: Databricks SQL Databricks Runtime 11.3 LTS e superior
Retorna a primeira substring que str
corresponde a regexp
.
Sintaxe
regexp_substr( str, regexp )
Argumentos
str
: UmaSTRING
expressão a ser correspondida.regexp
: UmaSTRING
expressão com um padrão.
Devoluções
A STRING
.
A regexp
cadeia de caracteres deve ser uma expressão regular Java.
Os literais de cadeia de caracteres não escapam. Por exemplo, para corresponder '\abc'
a , uma expressão regular para regexp
pode ser '^\\abc$'
.
No caso de uma malformação regexp
, a função retorna um erro INVALID_PARAMETER_VALUE .
Se o argumento for NULL
ou o padrão não for encontrado, o resultado será NULL
.
Exemplos
> SELECT regexp_substr('Steven Jones and Stephen Smith are the best players', 'Ste(v|ph)en');
Steven
> SELECT regexp_substr('Mary had a little lamb', 'Ste(v|ph)en');
NULL
> SELECT regexp_substr(NULL, 'Ste(v|ph)en');
NULL
> SELECT regexp_substr('Mary had a little lamb', NULL);
NULL