適用於：
SQL Server 2025 （17.x） Azure SQL Database AzureSQL Managed InstanceSQL database in Microsoft Fabric
傳回符合正則表示式模式之字串的一個子字串。 如果找不到相符專案，則會傳 NULL回 。
REGEXP_SUBSTR
(
string_expression,
pattern_expression [ , start [ , occurrence [ , flags [ , group ] ] ] ]
)
Note
規則運算式可在 Azure SQL 受控執行個體中使用 SQL Server 2025 或一 律up-to日期更新原則。
Arguments
string_expression
字元字串的表達式。
可以是字元字串的常數、變數或數據行。
數據類型： char、 nchar、 varchar 或 nvarchar。
Note
REGEXP_LIKE、 和REGEXP_COUNTREGEXP_INSTR函數支援 string_expression 參數的 LOB 類型 （varchar（max） 和 nvarchar（max）） 最多 2 MB。
pattern_expression
要比對的正則表達式模式。 通常是文字常值。
數據類型： char、 nchar、 varchar 或 nvarchar。 pattern_expression 支援最大字元長度 8,000 個字節。
start
指定搜尋字串內搜尋的起始位置。 Optional. 類型為 int 或 bigint。
編號是以 1 為基礎，這表示表達式中的第一個字元是 1 ，而且值必須是 >= 1。 如果啟動表達式小於 1，則傳回錯誤。 如果 start 表示式大於 string_expression長度，則函式會傳 NULL回 。 預設值為 1。
occurrence
表達式（正整數），指定要搜尋或取代來源字串內的模式運算式出現次數。 預設值為 1。 搜尋 string_expression的第一個字元。 針對正整數 n，它會搜尋第 n 個發生次數，從第一次出現pattern_expression之後的第一個字元開始，依此類推。
flags
一或多個字元，指定用於搜尋相符專案的修飾詞。 類型為 varchar 或 char，最多 30 個字元。
例如： ims 。 預設值為 c。 如果提供空字串 (' ') ，則會將它視為預設值 ('c')。 提供 c 或任何其他字元表達式。 如果旗標包含多個相互矛盾的字元，則 SQL Server 會使用最後一個字元。
例如，如果您指定 ic regex 會傳回區分大小寫的比對。
如果值包含支援 旗標值所列的字元，查詢會傳回錯誤，如下列範例所示：
Invalid flag provided. '<invalid character>' are not valid flags. Only {c,i,s,m} flags are valid.
支援的旗標值
| Flag | Description |
|---|---|
i |
不區分大小寫 （預設值 false） |
m |
多行模式： ^ 與 $ 比對開始/結束文字之外，還比對開始/結束文字 （預設值 false） |
s |
讓 . 比對 \n （預設值 false） |
c |
區分大小寫 （預設值 true） |
group
指定pattern_expression的擷取群組 （subexpression） 會決定要傳回string_expression內的位置。 擷取群組 （subexpression） 是以括弧括住的圖樣片段，可以巢狀化。
擷取群組會依其左括弧出現的順序編號。 群組的資料型態為 整數 ，且值必須大於或等 0於 ，且不得大於 pattern_expression中捕獲群（子表達式）的數量。 預設的群組值為 0，表示該位置是基於與整個模式相符的字串。
返回值
String.
Examples
從電子郵件位址擷取功能變數名稱。
SELECT REGEXP_SUBSTR(EMAIL, '@(.+)$', 1, 1, 'i', 1) AS DOMAIN
FROM CUSTOMERS;
在以元音開頭的句子中尋找第一個單字。
SELECT REGEXP_SUBSTR(COMMENT, '\b[aeiou]\w*', 1, 1, 'i') AS WORD
FROM FEEDBACK;
取得信用卡號碼的最後四位數。
SELECT REGEXP_SUBSTR(CARD_NUMBER, '\d{4}$') AS LAST_FOUR
FROM PAYMENTS;