適用於:
Databricks SQL
Databricks Runtime 11.3 LTS 和更新版本
傳回 str 中符合 regexp 的第一個子字串。
語法
regexp_substr( str, regexp )
引數
-
strSTRING:要比對的表達式。 -
regexpSTRING:具有模式的表達式。
傳回
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