REGEXP_COUNT(Transact-SQL) 预览版

适用于:SQL Server 2025 (17.x) 在Microsoft Fabric 中预览 Azure SQL 数据库Azure SQL 托管实例 SQL 数据库

注释

作为预览版功能,本文中介绍的技术受制于 Microsoft Azure 预览版补充使用条款

计算正则表达式模式在字符串中匹配的次数。

REGEXP_COUNT (
    string_expression,
    pattern_expression [ , start [ , flags ] ]
)

论据

string_expression

字符串的表达式。

可以是字符串的常量、变量或列。

数据类型: charncharvarcharnvarchar

注释

对于REGEXP_LIKEREGEXP_COUNT参数,函数REGEXP_INSTR函数支持 LOB 类型(varchar(max)nvarchar(max)最多 2 MB。

pattern_expression

要匹配的正则表达式模式。 通常是文本文本。

数据类型: charncharvarcharnvarcharpattern_expression 支持最大字符长度为 8,000 字节。

开始

指定搜索字符串中搜索的起始位置。 可选。 类型为 intbigint

编号是基于 1 的,这意味着表达式中的第一个字符是 1 且值必须是 >= 1。 如果起始表达式小于 1,则返回 pattern_expressionstring_expression中指定的第一个字符开始。 如果 start 表达式大于 string_expression的长度,则函数返回 0。 默认值为 1

如果启动表达式小于 1,查询将返回错误。

标志

指定用于搜索匹配项的修饰符的一个或多个字符。 类型为 varcharchar,最多包含 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

返回值

int

例子

计算字母 a 在每个产品名称中显示的次数。

SELECT PRODUCT_NAME,
       REGEXP_COUNT(PRODUCT_NAME, 'a') AS A_COUNT
FROM PRODUCTS;

计算有多少产品具有以 ing结尾的名称。

SELECT COUNT(*)
FROM PRODUCTS
WHERE REGEXP_COUNT(PRODUCT_NAME, 'ing$') > 0;

统计有多少产品具有包含三个连续共和项的名称,忽略大小写。

SELECT COUNT(*)
FROM PRODUCTS
WHERE REGEXP_COUNT(PRODUCT_NAME, '[^aeiou]{3}', 1, 'i') > 0;