適用対象:
Databricks SQL Databricks Runtime 11.3 LTS 以降
str の中で最初に regexp と一致する部分文字列を返します。
構文
regexp_substr( str, regexp )
引数
-
str: 照合するSTRING式。 -
regexp: パターンを含むSTRING式。
返品
STRING です。
regexp 文字列は Java の正規表現である必要があります。
文字列リテラルはエスケープされません。 たとえば、'\abc' に一致させるには、regexp の正規表現を '^\\abc$' にします。
regexp の形式に誤りがある場合、この関数は INVALID_PARAMETER_VALUE エラーを返します。
引数のどちらかが NULL であるか、パターンが見つからない場合、結果は NULL になります。
例
> 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