Freigeben über


regexp_substr-Funktion

Gilt für: Häkchen ja Databricks SQL Häkchen 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: 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_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