Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Si applica a:
Sql Server 2025 (17.x) DatabaseSQL di Azure Istanza gestita di SQL di Azurein Microsoft Fabric
Restituisce la posizione iniziale o finale della sottostringa corrispondente, a seconda del valore dell'argomento return_option.
REGEXP_INSTR
(
string_expression,
pattern_expression [ , start [ , occurrence [ , return_option [ , flags [ , group ] ] ] ] ]
)
Note
Le espressioni regolari sono disponibili in Istanza gestita di SQL di Azure con i criteri di aggiornamentodi SQL Server 2025 o Always-up-to-date.
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.
Note
Le REGEXP_LIKEfunzioni , REGEXP_COUNTe REGEXP_INSTR supportano i tipi LOB (varchar(max) e nvarchar(max)) fino a 2 MB per il parametro string_expression .
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
Specifica 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, restituisce l'errore . Se l'espressione iniziale è maggiore della lunghezza di string_expression, la funzione restituisce 0. Il valore predefinito è 1.
occurrence
Espressione (numero intero positivo) che specifica quale occorrenza dell'espressione del criterio all'interno della stringa di origine deve essere eseguita la ricerca o la sostituzione. Il valore predefinito è 1. Cerca il primo carattere del string_expression. Per un numero intero npositivo, cerca l'occorrenza nth che inizia con il primo carattere dopo la prima occorrenza del pattern_expression e così via.
return_option
Specifica se restituire la posizione iniziale o finale della sottostringa corrispondente. Usare 0 per l'inizio e 1 per la fine. Il valore predefinito è 0. La query restituisce un errore per qualsiasi altro valore.
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
| Flag | Description |
|---|---|
i |
Senza distinzione tra maiuscole e minuscole (impostazione predefinita false) |
m |
Modalità a più righe: ^ e $ corrispondenza della riga iniziale/finale oltre al testo di inizio/fine (impostazione predefinita false) |
s |
Let . match \n (impostazione predefinita false) |
c |
Distinzione tra maiuscole e minuscole (impostazione predefinita true) |
group
Specifica il gruppo di acquisizione (subexpression) di un pattern_expression determina la posizione all'interno di string_expression da restituire. Il gruppo è un frammento di pattern racchiuso tra parentesi e può essere annidato. I gruppi sono numerati nell'ordine in cui le parentesi sinistra vengono visualizzate nel criterio. Il valore è un numero intero e deve essere >= 0 e non deve essere maggiore del numero di gruppi nel pattern_expression. Il valore predefinito è 0, che indica che la posizione è basata sulla stringa che corrisponde all'intero pattern_expression.
Se il valore è maggiore del numero di gruppi in pattern_expression, la funzione restituisce 0.
Valore restituito
Integer.
Examples
Trovare la posizione della prima sottostringa che contiene solo cifre nella colonna PRODUCT_DESCRIPTION.
SELECT REGEXP_INSTR(PRODUCT_DESCRIPTION, '\d+')
FROM PRODUCTS;
Trovare la posizione della terza occorrenza della lettera a (senza distinzione tra maiuscole e minuscole) nella colonna PRODUCT_NAME.
SELECT REGEXP_INSTR(PRODUCT_NAME, 'a', 1, 3, 0, 'i')
FROM PRODUCTS;
Trovare la posizione della fine della prima sottostringa che inizia con t e termina con e (con distinzione tra maiuscole e minuscole) nella colonna PRODUCT_DESCRIPTION.
SELECT REGEXP_INSTR(PRODUCT_DESCRIPTION, 't.*?e', 1, 1, 1)
FROM PRODUCTS;