anteprima di REGEXP_LIKE (Transact-SQL)

Si applica a: SQL Server 2025 (17.x) Anteprima del databaseSQL di Azure Istanza gestita di SQL di Azurein Microsoft Fabric

Indica se il criterio di espressione regolare corrisponde a una stringa.

REGEXP_LIKE 
     (
      string_expression,
      pattern_expression [, flags ]
     )

REGEXP_LIKE richiede il livello di compatibilità del database 170 e versioni successive. Se il livello di compatibilità del database è inferiore a 170, REGEXP_LIKE non è disponibile. Altre funzioni scalari dell'espressione regolare sono disponibili a tutti i livelli di compatibilità.

È possibile controllare il livello di compatibilità nella vista sys.databases o nelle proprietà del database. È possibile modificare il livello di compatibilità di un database con il comando seguente:

ALTER DATABASE [DatabaseName] SET COMPATIBILITY_LEVEL = 170;

Argomenti

string_expression

Espressione di una stringa di caratteri.

Può essere una costante, una variabile o una colonna di stringa di caratteri.

Tipi di dati: char, nchar, varcharo nvarchar.

pattern_expression

Criterio di espressione regolare da trovare. In genere un valore letterale di testo.

Tipi di dati: char, nchar, varcharo nvarchar. pattern_expression supporta una lunghezza massima di caratteri di 8.000 byte.

flag

Uno o più caratteri che specificano i modificatori usati per la ricerca di corrispondenze. Il tipo è varchar o char, con un massimo di 30 caratteri.

Ad esempio, ims. Il valore predefinito è c. Se viene specificata una stringa vuota (' '), verrà considerata come valore predefinito ('c'). Specificare c o qualsiasi altra espressione di carattere. Se il flag contiene più caratteri contraddittori, SQL Server usa l'ultimo carattere.

Ad esempio, se si specifica ic l'espressione regolare restituisce la corrispondenza con distinzione tra maiuscole e minuscole.

Se il valore contiene un carattere diverso da quelli elencati in Valori flag supportati, la query restituisce un errore simile all'esempio seguente:

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

Valori dei flag supportati

Valore restituito

Valore booleano. true o false.

Osservazioni:

Per migliorare l'accuratezza della stima della cardinalità per la REGEXP_LIKE funzione, è possibile usare gli ASSUME_FIXED_MIN_SELECTIVITY_FOR_REGEXP hint di query e ASSUME_FIXED_MAX_SELECTIVITY_FOR_REGEXP per modificare i valori di selettività predefiniti. Per ulteriori informazioni, vedere i suggerimenti di query .

Questi hint di query sono integrati anche con il feedback di stima della cardinalità (CE). Il modello di feedback ce identifica automaticamente le query usando REGEXP_LIKE la funzione in cui esiste una differenza significativa tra i conteggi delle righe stimati e effettivi. Applica quindi l'hint di selettività appropriato a livello di query per migliorare la qualità del piano senza richiedere input manuale.

Per disabilitare questo comportamento automatico basato su feedback, abilitare il flag di traccia 16268.

Esempi

Selezionare tutti i record dalla tabella EMPLOYEES in cui il nome inizia con A e termina con Y

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

Selezionare tutti i record nella tabella ORDERS in cui la data dell'ordine è nel mese di febbraio 2020.

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

Selezionare tutti i record dalla tabella PRODUCTS in cui il nome del prodotto contiene almeno tre vocali consecutive

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

Creare una tabella employees con vincoli di CHECK per le colonne Email e 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})$'))  
);

Contenuto correlato

• Usare espressioni regolari
• funzioni espressioni regolari (Transact-SQL)