Fonction regexp_substr
S’applique à : Databricks SQL
Databricks Runtime 11.3 LTS et versions ultérieures
Retourne la première sous-chaîne de str
qui correspond à regexp
.
Syntaxe
regexp_substr( str, regexp )
Arguments
str
: expressionSTRING
à mettre en correspondance.regexp
: expressionSTRING
avec un modèle.
Retours
STRING
.
La chaîne regexp
doit être une expression régulière Java.
Les littéraux de chaîne ne sont pas placés dans une séquence d’échappement. Par exemple, pour qu’elle corresponde à '\abc'
, une expression régulière pour regexp
peut avoir la valeur '^\\abc$'
.
En cas de malformation de regexp
, la fonction retourne une erreur INVALID_PARAMETER_VALUE.
Si l’un des arguments correspond à NULL
ou si le modèle est introuvable, le résultat est NULL
.
Exemples
> 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