Modul plug-in sequence_detect

Článek
11/23/2024

Platí pro: ✅Microsoft Fabric✅Azure Data Explorer

Zjistí výskyty posloupnosti na základě zadaných predikátů. Modul plug-in se vyvolá pomocí operátoru evaluate .

Syntaxe

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

Přečtěte si další informace o konvencích syntaxe.

Parametry

Název	Type	Požadováno	Popis
T	`string`	✔️	Vstupní tabulkový výraz.
Časová osaSloupce	`string`	✔️	Odkaz na sloupec představující časovou osu musí být ve zdrojovém výrazu.
MaxSequenceStepWindow	`timespan`	✔️	Hodnota maximálního povoleného časového intervalu mezi 2 sekvenčními kroky v sekvenci.
MaxSequenceSpan	`timespan`	✔️	Maximální časový interval pro sekvenci pro dokončení všech kroků.
Výraz1, Výraz2, ...	`string`	✔️	Logické predikátové výrazy definující kroky sekvence.
Dim1, Dim2, ...	`string`	✔️	Výrazy dimenzí, které se používají ke korelaci sekvencí.

Návraty

Vrátí jednu tabulku, kde každý řádek v tabulce představuje jeden sekvencí výskyt:

Dim1, Dim2, ...: sloupce dimenzí, které byly použity ke korelaci sekvencí.
Výraz1TimelineColumn, Expr2TimelineColumn, ...: Sloupce s časovými hodnotami představující časovou osu každého kroku sekvence.
Doba trvání: časové období celkové posloupnosti

Příklady

Následující dotaz se podívá na tabulku T a vyhledá relevantní data z zadaného časového období.

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

Zkoumání událostí Stormu

Následující dotaz se podívá na tabulku StormEvents (statistika počasí pro rok 2007) a ukazuje případy, kdy během 5 dnů následovala sekvence "Nadměrné teplo".

Spuštění dotazu

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

Výstup

State	heat_StartTime	wildfire_StartTime	Doba trvání
KALIFORNIE	2007-05-08 00:00:00.0000000	2007-05-08 16:02:00.0000000	16:02:00
KALIFORNIE	2007-05-08 00:00:00.0000000	2007-05-10 11:30:00.0000000	2.11:30:00
KALIFORNIE	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
KALIFORNIE	2007-08-31 08:00:00.0000000	2007-09-01 11:28:00.0000000	1.03:28:00
KALIFORNIE	2007-08-31 08:00:00.0000000	2007-09-02 13:30:00.0000000	2.05:30:00
KALIFORNIE	2007-09-02 12:00:00.0000000	2007-09-02 13:30:00.0000000	01:30:00

Sdílet prostřednictvím