regexp_substr
-Funktion
Gilt für: Databricks SQL Databricks Runtime 11.3 LTS und höher
Gibt den ersten Substring in str
zurück, die mit regexp
übereinstimmt.
Syntax
regexp_substr( str, regexp )
Argumente
str
: EinSTRING
-Ausdruck, der abgeglichen werden soll.regexp
: EinSTRING
-Ausdruck mit einem Muster.
Gibt zurück
Ein STRING
.
Die regexp
-Zeichenfolge muss ein regulärer Java-Ausdruck sein.
Für Zeichenfolgenliterale werden keine Escapezeichen verwendet. Um beispielsweise '\abc'
abzugleichen, kann ein regulärer Ausdruck für regexp
'^\\abc$'
sein.
Im Fall eines fehlformierten regexp
gibt die Funktion den Fehler INVALID_PARAMETER_VALUE zurück.
Wenn ein Argument NULL
ist oder das Muster nicht gefunden werden kann, ist das Ergebnis NULL
.
Beispiele
> 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