regexp_instr
-Funktion
Gilt für: Databricks SQL Databricks Runtime 11.3 LTS und höher
Gibt die Position des ersten Substrings in str
zurück, die mit regexp
übereinstimmt.
Syntax
regexp_instr( 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_instr('Steven Jones and Stephen Smith are the best players', 'Ste(v|ph)en');
1
> SELECT regexp_instr('Mary had a little lamb', 'Ste(v|ph)en');
0
> SELECT regexp_instr(NULL, 'Ste(v|ph)en');
NULL
> SELECT regexp_instr('Mary had a little lamb', NULL);
NULL