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 INTEGER-Element.

Die Zeichenfolge regexp muss ein Java regulärer Ausdruck sein. Die Funktion hebt Zeichenfolgenliterale auf. 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 eines der Argumente NULL ist, dann ist das Ergebnis NULL. Wenn das Muster nicht gefunden wird, lautet 0das Ergebnis .

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