Condividi tramite


extract_all()

Si applica a: ✅Microsoft Fabric✅Azure Esplora dati Azure MonitorMicrosoft Sentinel

Ottenere tutte le corrispondenze per un'espressione regolare da una stringa di origine. Facoltativamente, recuperare un subset di gruppi corrispondenti.

print extract_all(@"(\d+)", "a set of numbers: 123, 567 and 789") // results with the dynamic array ["123", "567", "789"]

Alias deprecati: extractall()

Sintassi

extract_all(regex, [captureGroups,] source)

Altre informazioni sulle convenzioni di sintassi.

Parametri

Nome Digita Obbligatorio Descrizione
regex string ✔️ Espressione regolare contenente tra uno e 16 gruppi di acquisizione.
captureGroups dynamic Matrice che indica i gruppi di acquisizione da estrarre. I valori validi sono compresi tra 1 e il numero di gruppi di acquisizione nell'espressione regolare. Sono consentiti anche gruppi di acquisizione denominati. Vedere esempi.
source string ✔️ Stringa in cui effettuare la ricerca.

Valori restituiti

  • Se regex trova una corrispondenza nell'origine: restituisce una matrice dinamica che include tutte le corrispondenze rispetto ai gruppi di acquisizione indicati captureGroups o a tutti i gruppi di acquisizione nell'espressione regolare.
  • Se il numero di captureGroups è 1: la matrice restituita ha una singola dimensione di valori corrispondenti.
  • Se il numero di captureGroups è maggiore di 1: la matrice restituita è una raccolta bidimensionale di corrispondenze multivalore per ogni selezione captureGroups o tutti i gruppi di acquisizione presenti nell'espressione regolare se captureGroups viene omesso.
  • Se non esiste alcuna corrispondenza: null.

Esempi

Estrarre un singolo gruppo di acquisizione

La query seguente restituisce la rappresentazione in byte esadecimale (due cifre esadecimale) del GUID.

print Id="82b8be2d-dfa7-4bd1-8f63-24ad26d31449"
| extend guid_bytes = extract_all(@"([\da-f]{2})", Id) 

Output

ID guid_bytes
82b8be2d-dfa7-4bd1-8f63-24ad26d31449 ["82","b8","be","2d","df","a7","4b","d1","8f","63","24","ad","26","d3","14","49"]

Estrarre diversi gruppi di acquisizione

Nella query seguente viene usata un'espressione regolare con tre gruppi di acquisizione per suddividere ogni parte GUID in prima lettera, ultima lettera e qualsiasi cosa si trova al centro.

print Id="82b8be2d-dfa7-4bd1-8f63-24ad26d31449"
| extend guid_bytes = extract_all(@"(\w)(\w+)(\w)", Id)

Output

ID guid_bytes
82b8be2d-dfa7-4bd1-8f63-24ad26d31449 [["8","2b8be2","d"],["d","fa","7"],["4","bd","1"],["8","f6","3"],["2","4ad26d3144","9"]]

Estrarre un subset di gruppi di acquisizione

La query seguente seleziona un subset di gruppi di acquisizione.

L'espressione regolare corrisponde alla prima lettera, all'ultima lettera e a tutte le altre.

Il parametro captureGroups viene usato per selezionare solo la prima e l'ultima parte.

print Id="82b8be2d-dfa7-4bd1-8f63-24ad26d31449"
| extend guid_bytes = extract_all(@"(\w)(\w+)(\w)", dynamic([1,3]), Id) 

Output

ID guid_bytes
82b8be2d-dfa7-4bd1-8f63-24ad26d31449 [["8","d"],["d","7"],["4","1"],["8","3"],["2","9"]]

Uso di gruppi di acquisizione denominati

Gli captureGroups nella query seguente usano sia gli indici del gruppo di acquisizione che i riferimenti ai gruppi di acquisizione denominati per recuperare i valori corrispondenti.

print Id="82b8be2d-dfa7-4bd1-8f63-24ad26d31449"
| extend guid_bytes = extract_all(@"(?P<first>\w)(?P<middle>\w+)(?P<last>\w)", dynamic(['first',2,'last']), Id) 

Output

ID guid_bytes
82b8be2d-dfa7-4bd1-8f63-24ad26d31449 [["8","2b8be2","d"],["d","fa","7"],["4","bd","1"],["8","f6","3"],["2","4ad26d3144","9"]]