REGEXP_COUNT (Transact-SQL)

Si applica a: Endpoint di analisi SQL di Sql Server 2025 (17.x) del database SQL diAzurein Microsoft Fabric e warehouse neldatabase SQL di Microsoft Fabric in Microsoft Fabric

La REGEXP_COUNT funzione di espressione regolare scalare conta il numero di volte in cui un pattern di espressione regolare viene abbinato in una stringa.

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

Arguments

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.

start

Specificare la posizione iniziale per la ricerca all'interno della stringa di ricerca. Optional. Il tipo è int o bigint.

La numerazione è basata su 1, ovvero il primo carattere nell'espressione è 1 e il valore deve essere >= 1. Se l'espressione iniziale è minore di 1, il pattern_expression restituito inizia al primo carattere specificato in string_expression. Se l'espressione iniziale è maggiore della lunghezza di string_expression, la funzione restituisce 0. Il valore predefinito è 1.

Se l'espressione iniziale è minore di 1, la query restituisce un errore.

flags

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

int

Supporto della piattaforma

• In Istanza gestita di SQL di Azure, le funzioni di espressioni regolari T-SQL sono disponibili solo con la politica di aggiornamentoSQL Server 2025 o Always-up-to-date.
• Le funzioni di espressione regolare T-SQL sono disponibili in database SQL di Azure, SQL database in Fabric e a partire da SQL Server 2025.
• Le funzioni di espressione regolare T-SQL non sono disponibili in SQL Server 2022 o versioni precedenti.
• Le funzioni scalari di espressioni regolari di T-SQL sono disponibili come funzione di anteprima in Fabric Data Warehouse. Per maggiori informazioni, vedi Funzioni di espressioni regolari in Fabric Data Warehouse. Le funzioni a valori di tabella con espressioni regolari di T-SQL non sono disponibili in Fabric Data Warehouse.

Examples

Contare il numero di volte in cui la lettera a viene visualizzata in ogni nome del prodotto.

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

Contare il numero di prodotti con un nome che termina con ing.

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

Contare il numero di prodotti con un nome che contiene tre consonanti consecutivi, ignorando la distinzione tra maiuscole e minuscole.

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

Contenuti correlati

• Funzioni di espressioni regolari