Freigeben über


regexp_instr-Funktion

Gilt für: Häkchen ja Databricks SQL Häkchen bei ja 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: Ein STRING-Ausdruck, der abgeglichen werden soll.
  • regexp: Ein STRING-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