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 Zeichenfolge regexp muss ein Java regulärer 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.

Häufige Fehlerbedingungen

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

> SELECT regexp_instr('abc', '[invalid');
  Error: INVALID_PARAMETER_VALUE.PATTERN