Plug-in sequence_detect

Artigo
11/23/2024

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

Detecta ocorrências de sequência com base nos predicados fornecidos. O plug-in é invocado com o evaluate operador.

Sintaxe

T sequence_detect(| evaluate TimelineColumn, MaxSequenceStepWindow, MaxSequenceSpan, Expr1, Expr2, ..., Dim1, Dim2 ...,)

Saiba mais sobre as convenções de sintaxe.

Parâmetros

Nome	Digitar	Obrigatória	Descrição
T	`string`	✔️	A expressão tabular de entrada.
Coluna da linha do tempo	`string`	✔️	A referência de coluna que representa a linha do tempo deve estar presente na expressão de origem.
MaxSequenceStepWindow	`timespan`	✔️	O valor do intervalo de tempo máximo permitido entre 2 etapas sequenciais na sequência.
MaxSequenceSpan	`timespan`	✔️	O período máximo de tempo para a sequência concluir todas as etapas.
Expr1, Expr2, ...	`string`	✔️	As expressões de predicado booleano que definem as etapas da sequência.
Dim1, Dim2, ...	`string`	✔️	As expressões de dimensão usadas para correlacionar sequências.

Devoluções

Retorna uma única tabela em que cada linha da tabela representa uma única ocorrência de sequência:

Dim1, Dim2, ...: colunas de dimensão que foram usadas para correlacionar sequências.
Expr1 TimelineColumn, Expr2TimelineColumn, ...: colunas com valores de tempo, representando a linha do tempo de cada etapa da sequência.
Duração: a janela de tempo da sequência geral

Exemplos

A consulta a seguir examina a tabela T para pesquisar dados relevantes de um período de tempo especificado.

T | evaluate sequence_detect(datetime_column, 10m, 1h, e1 = (Col1 == 'Val'), e2 = (Col2 == 'Val2'), Dim1, Dim2)

Explorando eventos de tempestade

A consulta a seguir examina a tabela StormEvents (estatísticas meteorológicas de 2007) e mostra casos em que a sequência de 'Calor Excessivo' foi seguida por 'Incêndio Florestal' em 5 dias.

Executar a consulta

StormEvents
| evaluate sequence_detect(
               StartTime,
               5d,  // step max-time
               5d,  // sequence max-time
               heat=(EventType == "Excessive Heat"), 
               wildfire=(EventType == 'Wildfire'), 
               State
           )

Saída

Estado	heat_StartTime	wildfire_StartTime	Duration
CALIFÓRNIA	2007-05-08 00:00:00.0000000	2007-05-08 16:02:00.0000000	16:02:00
CALIFÓRNIA	2007-05-08 00:00:00.0000000	2007-05-10 11:30:00.0000000	2.11:30:00
CALIFÓRNIA	2007-07-04 09:00:00.0000000	2007-07-05 23:01:00.0000000	1.14:01:00
DAKOTA DO SUL	2007-07-23 12:00:00.0000000	2007-07-27 09:00:00.0000000	3.21:00:00
TEXAS	2007-08-10 08:00:00.0000000	2007-08-11 13:56:00.0000000	1.05:56:00
CALIFÓRNIA	2007-08-31 08:00:00.0000000	2007-09-01 11:28:00.0000000	1.03:28:00
CALIFÓRNIA	2007-08-31 08:00:00.0000000	2007-09-02 13:30:00.0000000	2.05:30:00
CALIFÓRNIA	2007-09-02 12:00:00.0000000	2007-09-02 13:30:00.0000000	01:30:00

Partilhar via