Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
Aplica-se a: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel
Obtenha todas as correspondências para uma expressão regular de uma cadeia de caracteres de origem. Opcionalmente, recupere um subconjunto de grupos correspondentes.
print extract_all(@"(\d+)", "a set of numbers: 123, 567 and 789") // results with the dynamic array ["123", "567", "789"]
Aliases preteridos: extractall()
Sintaxe
extract_all(
regex, [capturaGrupos,] fonte)
Saiba mais sobre convenções de sintaxe.
Parâmetros
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| regex | string |
✔️ | Uma expressão regular contendo entre um e 16 grupos de captura. |
| captureGroups | dynamic |
Uma matriz que indica os grupos de captura a serem extraídos. Os valores válidos são de 1 para o número de grupos de captura na expressão regular. Grupos de captura nomeados também são permitidos. Ver exemplos. | |
| fonte | string |
✔️ | A cadeia de caracteres a ser pesquisada. |
Devoluções
- Se o regex encontrar uma correspondência na origem: retorna a matriz dinâmica, incluindo todas as correspondências em relação aos grupos de captura indicados, captureGroups ou todos os grupos de captura no regex.
- Se o número de captureGroups for 1: A matriz retornada tem uma única dimensão de valores correspondentes.
- Se o número de captureGroups for maior que 1: A matriz retornada é uma coleção bidimensional de correspondências de vários valores por seleção captureGroups , ou todos os grupos de captura presentes no regex se captureGroups for omitido.
- Se não houver correspondência:
null.
Exemplos
O exemplo a seguir extrai uma única captura de grupo, retornando uma representação de hex-byte (dois hex-digits) do GUID.
print Id="82b8be2d-dfa7-4bd1-8f63-24ad26d31449"
| extend guid_bytes = extract_all(@"([\da-f]{2})", Id)
Realização
| Nº de Identificação | guid_bytes |
|---|---|
| 82b8be2d-dfa7-4bd1-8f63-24ad26d31449 | ["82","b8","be","2d","df","a7","4b","d1","8f","63","24","ad","26","d3","14","49"] |
O exemplo a seguir usa uma expressão regular com três grupos de captura para dividir cada parte do GUID em primeira letra, última letra e o que estiver no meio.
print Id="82b8be2d-dfa7-4bd1-8f63-24ad26d31449"
| extend guid_bytes = extract_all(@"(\w)(\w+)(\w)", Id)
Realização
| Nº de Identificação | guid_bytes |
|---|---|
| 82b8be2d-dfa7-4bd1-8f63-24ad26d31449 | [["8","2b8be2","d"],["d","fa","7"],["4","bd","1"],["8","f6","3"],["2","4ad26d3144","9"]] |
O exemplo a seguir seleciona um subconjunto de grupos de captura.
A expressão regular corresponde à primeira letra, à última letra e a todo o resto.
O parâmetro captureGroups é usado para selecionar apenas a primeira e a última partes.
print Id="82b8be2d-dfa7-4bd1-8f63-24ad26d31449"
| extend guid_bytes = extract_all(@"(\w)(\w+)(\w)", dynamic([1,3]), Id)
Realização
| Nº de Identificação | guid_bytes |
|---|---|
| 82b8be2d-dfa7-4bd1-8f63-24ad26d31449 | [["8","d"],["d","7"],["4","1"],["8","3"],["2","9"]] |
O exemplo a seguir mostra como captureGroups usa índices de grupo de captura e referências de grupo de captura nomeado para buscar valores correspondentes.
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)
Realização
| Nº de Identificação | guid_bytes |
|---|---|
| 82b8be2d-dfa7-4bd1-8f63-24ad26d31449 | [["8","2b8be2","d"],["d","fa","7"],["4","bd","1"],["8","f6","3"],["2","4ad26d3144","9"]] |