Função regexp_substr
Aplica-se a: SQL do Databricks Databricks Runtime 11.3 LTS e versões posteriores
Retorna a primeira substring em str
que combine regexp
.
Sintaxe
regexp_substr( str, regexp )
Argumentos
str
: uma expressãoSTRING
a ser correspondida.regexp
: uma expressãoSTRING
com um padrão.
Retornos
Um STRING
.
A cadeia de caracteres regexp
deve ser uma expressão regular Java.
Os literais de cadeia de caracteres não têm caracteres de escape. Por exemplo, para fazer a correspondência de '\abc'
, uma expressão regular para regexp
pode ser '^\\abc$'
.
No caso de um regexp
malformado, a função retorna um erro INVALID_PARAMETER_VALUE.
Se um dos argumentos 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