Plug-in sequence_detect

Articolo
11/23/2024

Si applica a: ✅Microsoft Fabric✅Azure Esplora dati

Rileva le occorrenze di sequenza in base ai predicati forniti. Il plug-in viene richiamato con l'operatore evaluate .

Sintassi

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

Altre informazioni sulle convenzioni di sintassi.

Parametri

Nome	Digita	Obbligatorio	Descrizione
T	`string`	✔️	Espressione tabulare di input.
TimelineColumn	`string`	✔️	Il riferimento di colonna che rappresenta la sequenza temporale deve essere presente nell'espressione di origine.
MaxSequenceStepWindow	`timespan`	✔️	Valore dell'intervallo di tempo massimo consentito tra 2 passaggi sequenziali nella sequenza.
MaxSequenceSpan	`timespan`	✔️	Intervallo di tempo massimo per la sequenza per completare tutti i passaggi.
Expr1, Expr2, ...	`string`	✔️	Espressioni di predicato booleane che definiscono i passaggi della sequenza.
Dim1, Dim2, ...	`string`	✔️	Espressioni di dimensione utilizzate per correlare le sequenze.

Valori restituiti

Restituisce una singola tabella in cui ogni riga della tabella rappresenta una singola occorrenza di sequenza:

Dim1, Dim2, ...: colonne delle dimensioni usate per correlare le sequenze.
Expr1TimelineColumn, Expr2TimelineColumn, ...: Colonne con valori di ora, che rappresentano la sequenza temporale di ogni passaggio della sequenza.
Durata: intervallo di tempo complessivo della sequenza

Esempi

La query seguente esamina la tabella T per cercare i dati pertinenti da un periodo di tempo specificato.

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

Esplorazione degli eventi Storm

La query seguente cerca nella tabella StormEvents (statistiche meteo per il 2007) e mostra i casi in cui la sequenza di "Eccessivo calore" è stata seguita da "Wildfire" entro 5 giorni.

Eseguire la query

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

Output

Provincia	heat_StartTime	wildfire_StartTime	Durata
CALIFORNIA	2007-05-08 00:00:00.0000000	2007-05-08 16:02:00.0000000	16:02:00
CALIFORNIA	2007-05-08 00:00:00.0000000	2007-05-10 11:30:00.0000000	2.11:30:00
CALIFORNIA	2007-07-04 09:00:00.0000000	2007-07-05 23:01:00.0000000	1.14:01:00
SOUTH DAKOTA	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
CALIFORNIA	2007-08-31 08:00:00.0000000	2007-09-01 11:28:00.0000000	1.03:28:00
CALIFORNIA	2007-08-31 08:00:00.0000000	2007-09-02 13:30:00.0000000	2.05:30:00
CALIFORNIA	2007-09-02 12:00:00.0000000	2007-09-02 13:30:00.0000000	01:30:00

Condividi tramite