REGEXP_COUNT (Transact-SQL)

S’applique à : Point de terminaison d’analyse SQL Server 2025 (17.x) Azure SQL DatabaseAzure SQL Managed InstanceSQL dans Microsoft Fabric et Warehouse dans labase de données Microsoft Fabric SQL dans Microsoft Fabric

La REGEXP_COUNT fonction d’expression régulière scalaire compte le nombre de fois où un motif d’expression régulière est apparié dans une chaîne.

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

Arguments

string_expression

Expression d’une chaîne de caractères.

Il peut s’agir d’une constante, d’une variable ou d’une colonne de chaîne de caractères.

Types de données : char, nchar, varcharou nvarchar.

Note

Les REGEXP_* fonctions prennent en charge les types de LOB (varchar(max) et nvarchar(max)) jusqu’à 2 Mo pour le paramètre string_expression .

pattern_expression

Modèle d’expression régulière à mettre en correspondance. Généralement un littéral de texte.

Types de données : char, nchar, varcharou nvarchar. pattern_expression prend en charge une longueur maximale de caractères de 8 000 octets.

start

Spécifiez la position de départ de la recherche dans la chaîne de recherche. Optional. Le type est int ou bigint.

La numérotation est basée sur 1, ce qui signifie que le premier caractère de l’expression est 1 et que la valeur doit être >= 1. Si l’expression de début est inférieure 1à , la pattern_expression retournée commence au premier caractère spécifié dans string_expression. Si l’expression de début est supérieure à la longueur de string_expression, la fonction retourne 0. La valeur par défaut est 1.

Si l’expression de début est inférieure à 1, la requête retourne une erreur.

flags

Un ou plusieurs caractères qui spécifient les modificateurs utilisés pour rechercher des correspondances. Le type est varchar ou char, avec un maximum de 30 caractères.

Par exemple, ims. La valeur par défaut est c. Si une chaîne vide (' ') est fournie, elle sera traitée comme la valeur par défaut ('c'). Fournissez c ou toute autre expression de caractère. Si l’indicateur contient plusieurs caractères contradictoires, SQL Server utilise le dernier caractère.

Par exemple, si vous spécifiez ic l’expression régulière retourne la correspondance respectant la casse.

Si la valeur contient un caractère autre que ceux répertoriés dans valeurs d’indicateur prises en charge, la requête retourne une erreur comme dans l’exemple suivant :

Invalid flag provided. '<invalid character>' are not valid flags. Only {c,i,s,m} flags are valid.

Valeurs d’indicateur prises en charge

Flag	Description
i	Respect de la casse (valeur par défaut false)
m	Mode multiligne : ^ et $ mettre en correspondance la ligne de début/fin en plus du texte de début/fin (valeur par défaut false)
s	Laisser . correspondre \n (valeur par défaut false)
c	Respect de la casse (valeur par défaut true)

Valeur retournée

int

Support de la plateforme

• En Azure SQL Managed Instance, les fonctions d’expression régulière T-SQL sont disponibles uniquement avec la politique de mise à jourSQL Server 2025 ou Always-up-to-date.
• Les fonctions d’expression régulière T-SQL sont disponibles dans Azure SQL Database, SQL Database dans Fabric, et à partir de SQL Server 2025.
• Les fonctions d'expression régulière T-SQL ne sont pas disponibles dans SQL Server 2022 ni dans les versions antérieures.
• Les fonctions scalaires d’expressions régulières T-SQL sont disponibles en tant que fonction de prévisualisation dans Fabric Data Warehouse. Pour plus d’informations, voir Fonctions d’expressions régulières dans Fabric Data Warehouse. Les fonctions à valeurs de table d’expressions régulières T-SQL ne sont pas disponibles dans Fabric Data Warehouse.

Examples

Comptez le nombre de fois où la lettre a apparaît dans chaque nom de produit.

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

Comptez le nombre de produits dont le nom se termine par ing.

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

Comptez le nombre de produits dont le nom contient trois consonnes consécutives, ignorant la casse.

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

Contenu connexe

• Fonctions d’expressions régulières