适用于：
SQL Server 2025 （17.x） 在Microsoft Fabric 中预览 Azure SQL 数据库Azure SQL 托管实例 SQL 数据库
注释
作为预览版功能，本文中介绍的技术受制于 Microsoft Azure 预览版补充使用条款。
根据参数的值返回匹配的子字符串的 return_option 起始或结束位置。
REGEXP_INSTR
(
string_expression,
pattern_expression
[, start [, occurrence [, return_option [, flags [, group ] ] ] ] ]
)
论据
string_expression
字符串的表达式。
可以是字符串的常量、变量或列。
数据类型： char、 nchar、 varchar 或 nvarchar。
注释
对于REGEXP_LIKEREGEXP_COUNT参数，函数REGEXP_INSTR和函数支持 LOB 类型（varchar（max）和 nvarchar（max）最多 2 MB。
pattern_expression
要匹配的正则表达式模式。 通常是文本文本。
数据类型： char、 nchar、 varchar 或 nvarchar。 pattern_expression 支持最大字符长度为 8,000 字节。
开始
指定搜索字符串中搜索的起始位置。 可选。 类型为 int 或 bigint。
编号是基于 1 的，这意味着表达式中的第一个字符是 1 且值必须是 >= 1。 如果起始表达式小于 1，则返回错误。 如果 start 表达式大于 string_expression的长度，则函数返回 0。 默认值为 1。
事件
一个表达式（正整数），指定要在源字符串中搜索或替换模式表达式的匹配项。 默认值为 1。 搜索 string_expression的第一个字符。 对于正整数 n，它将搜索 nth 从第一个匹配项之后的第一个字符开始的 pattern_expression，依此类推。
return_option
指定是返回匹配子字符串的开始位置还是结束位置。 用于 0 开始和 1 结束。 默认值是 0。 查询返回任何其他值的错误。
旗
指定用于搜索匹配项的修饰符的一个或多个字符。 类型为 varchar 或 char，最多包含 30 个字符。
例如，ims。 默认值为 c。 如果提供了空字符串 (' ') ，它将被视为默认值 ('c')。 提供 c 或任何其他字符表达式。 如果标志包含多个相互矛盾的字符，则 SQL Server 使用最后一个字符。
例如，如果指定 ic 正则表达式返回区分大小写的匹配。
如果值包含除 受支持标志值中列出的字符以外的字符，则查询将返回如下例所示的错误：
Invalid flag provided. '<invalid character>' are not valid flags. Only {c,i,s,m} flags are valid.
支持的标志值
| 旗帜 | DESCRIPTION |
|---|---|
i |
不区分大小写 （默认值 false） |
m |
多行模式： ^ 和 $ 匹配开始/结束行，以及开始/结束文本（默认值 false） |
s |
让 . 匹配 \n （默认值 false） |
c |
区分大小写（默认值 true） |
组
指定subexpression的捕获组 （） 确定要返回string_expression内的位置。 该组是括在括号中的模式片段，可以嵌套。 按其左括号以模式显示的顺序对组进行编号。 该值是一个整数，必须 >= 0 且不能大于 pattern_expression中的组数。 默认值为 0，指示位置基于与整个 pattern_expression匹配的字符串。
如果该值大于 pattern_expression中的组数，则函数返回 0。
返回值
整数。
例子
查找仅包含列中数字 PRODUCT_DESCRIPTION 的第一个子字符串的位置。
SELECT REGEXP_INSTR(PRODUCT_DESCRIPTION, '\d+')
FROM PRODUCTS;
查找列中第三个字母 a （不区分大小写） PRODUCT_NAME 的位置。
SELECT REGEXP_INSTR(PRODUCT_NAME, 'a', 1, 3, 0, 'i')
FROM PRODUCTS;
查找第一个子字符串的末尾的位置，该子字符串以 （区分大小写）开头 t ，以 e （区分大小写） PRODUCT_DESCRIPTION 开头。
SELECT REGEXP_INSTR(PRODUCT_DESCRIPTION, 't.*?e', 1, 1, 1)
FROM PRODUCTS;