aperçu REGEXP_LIKE (Transact-SQL)

2025-06-16

S’applique à : SQL Server 2025 (17.x) Préversion de la base de données SQL Azure SQL Database Azure SQL Managed Instance SQL dans Microsoft Fabric

Remarque

En tant que fonctionnalité en préversion, la technologie présentée dans cet article est soumise à conditions d’utilisation supplémentaires pour les préversions Microsoft Azure.

Indique si le modèle d’expression régulière correspond dans une chaîne.

REGEXP_LIKE 
     (
      string_expression,
      pattern_expression [, flags ]
     )

REGEXP_LIKE nécessite le niveau de compatibilité de la base de données 170 et versions ultérieures. Si le niveau de compatibilité de la base de données est inférieur à 170, REGEXP_LIKE n’est pas disponible. D’autres fonctions scalaires d’expression régulière sont disponibles à tous les niveaux de compatibilité.

Vous pouvez vérifier le niveau de compatibilité dans la vue sys.databases ou dans les propriétés de base de données. Vous pouvez modifier le niveau de compatibilité d’une base de données avec la commande suivante :

ALTER DATABASE [DatabaseName] SET COMPATIBILITY_LEVEL = 170;

Les 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.

Remarque

Les REGEXP_LIKEfonctions et REGEXP_COUNT les REGEXP_INSTRtypes métier prennent en charge les types métier (varchar(max) et nvarchar(max)) jusqu’à 2 Mo pour le paramètre string_expression.

expression_de_modèle

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.

indicateurs

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

Drapeau	Descriptif
`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 de retour

Valeur booléenne. true ou false.

Remarques

Pour améliorer la précision de l’estimation de cardinalité pour la REGEXP_LIKE fonction, vous pouvez utiliser les indicateurs de requête et ASSUME_FIXED_MIN_SELECTIVITY_FOR_REGEXP les ASSUME_FIXED_MAX_SELECTIVITY_FOR_REGEXP indicateurs de requête pour ajuster les valeurs de sélection par défaut. Pour plus d’informations, consultez indicateurs de requête.

Ces indicateurs de requête sont également intégrés aux commentaires d’estimation de cardinalité (CE). Le modèle de commentaires CE identifie automatiquement les requêtes à l’aide REGEXP_LIKE de la fonction où il existe une différence significative entre les nombres de lignes estimés et réels. Il applique ensuite l’indicateur de sélection approprié au niveau de la requête pour améliorer la qualité du plan sans nécessiter d’entrée manuelle.

Pour désactiver ce comportement automatique basé sur les commentaires, activez l’indicateur de trace 16268.

Exemples

Sélectionnez tous les enregistrements dans la table EMPLOYEES où le prénom commence par A et se termine par Y

SELECT * FROM EMPLOYEES WHERE REGEXP_LIKE (FIRST_NAME, '^A.*Y$');

Sélectionnez tous les enregistrements dans la table ORDERS où la date de commande est en février 2020.

SELECT * FROM ORDERS WHERE REGEXP_LIKE (ORDER_DATE, '2020-02-\d\d');

Sélectionnez tous les enregistrements dans la table PRODUCTS où le nom du produit contient au moins trois voyelles consécutives

SELECT * FROM PRODUCTS WHERE REGEXP_LIKE (PRODUCT_NAME, '[AEIOU]{3,}');

Créez une table employés avec des contraintes de CHECK pour les colonnes Email et Phone_Number.

DROP TABLE IF EXISTS EMPLOYEES;

CREATE TABLE EMPLOYEES (  
    ID INT IDENTITY(101,1),  
    [Name] VARCHAR(150),  
    Email VARCHAR(320)  
    CHECK (REGEXP_LIKE(Email, '^[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Za-z]{2,}$')),  
    Phone_Number NVARCHAR(20)  
    CHECK (REGEXP_LIKE (Phone_Number, '^(\d{3})-(\d{3})-(\d{4})$'))  
);

Partager via