Partilhar via

extrato()

Aplica-se a: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel

Obtenha uma correspondência para um de expressão regular de uma cadeia de caracteres de origem.

Opcionalmente, converta a substring extraída para o tipo indicado.

Sintaxe

extract( regex,captureGroup,fonte [,typeLiteral])

Saiba mais sobre convenções de sintaxe.

Parâmetros

Designação Tipo Necessário Descrição
regex string ✔️ Uma expressão regular .
captureGroup [en] int ✔️ O grupo de captura a ser extraído. 0 representa toda a correspondência, 1 para o valor correspondido pelo primeiro '('parênteses')' na expressão regular e 2 ou mais para parênteses subsequentes.
fonte string ✔️ A cadeia de caracteres a ser pesquisada.
tipo literal string Se fornecida, a substring extraída é convertida para esse tipo. Por exemplo, typeof(long).

Devoluções

Se regex encontrar uma correspondência em de origem: a substring correspondeu ao grupo de captura indicado captureGroup, opcionalmente convertida para typeLiteral.

Se não houver correspondência ou se a conversão de tipo falhar: null.

Exemplos

O exemplo a seguir extrai o nome de usuário, email, idade da cadeia de caracteres. A expressão regular é usada para extrair as informações.

Executar a consulta

let _data = datatable(Text: string)
[
"User: James, Email: James@example.com, Age: 29",
"User: David, Age: 35"
];
_data |
extend UserName = extract("User: ([^,]+)", 1, Text),
       EmailId = extract(@"Email: (\S+),", 1, Text),
       Age = extract(@"\d+", 0, Text)

Realização

Texto UserName EmailId Age
Usuário: James, Email: James@example.com, Idade: 29 Tiago James@example.com 29
Usuário: David, Idade: 35 David 35

O exemplo a seguir extrai o mês da cadeia de caracteres Dates e retorna uma tabela com a cadeia de caracteres de data e o mês como tipo int.

Executar a consulta

let Dates = datatable(DateString: string)
[
    "15-12-2024",
    "21-07-2023",
    "10-03-2022"
];
Dates
| extend Month = extract(@"-(\d{2})-", 1, DateString, typeof(int))
| project DateString, Month

Realização

DateString Month
15-12-2024 12
21-07-2023 7
10-03-2022 3

Conteúdo relacionado

  • Last updated on