Udostępnij za pośrednictwem


sequence_detect, wtyczka

Dotyczy: ✅Microsoft Fabric✅Azure Data Explorer

Wykrywa wystąpienia sekwencji na podstawie podanych predykatów. Wtyczka jest wywoływana z operatorem evaluate .

Składnia

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

Dowiedz się więcej na temat konwencji składni.

Parametry

Nazwisko Type Wymagania opis
T string ✔️ Wyrażenie tabelaryczne danych wejściowych.
Kolumna osi czasu string ✔️ Odwołanie do kolumny reprezentujące oś czasu musi znajdować się w wyrażeniu źródłowym.
MaxSequenceStepWindow timespan ✔️ Wartość maksymalnego dozwolonego przedziału czasu między 2 krokami sekwencyjnymi w sekwencji.
MaxSequenceSpan timespan ✔️ Maksymalny przedział czasu sekwencji do wykonania wszystkich kroków.
Expr1, Expr2, ... string ✔️ Wyrażenia predykatu logicznego definiujące kroki sekwencji.
Dim1, Dim2, ... string ✔️ Wyrażenia wymiarów używane do korelowania sekwencji.

Zwraca

Zwraca pojedynczą tabelę, w której każdy wiersz w tabeli reprezentuje pojedyncze wystąpienie sekwencji:

  • Dim1, Dim2, ...: kolumny wymiarów używane do korelowania sekwencji.
  • Expr1TimelineColumn, Expr2TimelineColumn, ...: Kolumny z wartościami czasu reprezentującymi oś czasu każdego kroku sekwencji.
  • Czas trwania: ogólny przedział czasu sekwencji

Przykłady

Poniższe zapytanie analizuje tabelę T, aby wyszukać odpowiednie dane z określonego okresu.

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

Eksplorowanie zdarzeń Storm

Poniższe zapytanie analizuje tabelę StormEvents (statystyki pogody dla 2007 r.) i pokazuje przypadki, w których sekwencja "Nadmierne ciepło" nastąpiła po "Wildfire" w ciągu 5 dni.

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

Wyjście

Stan heat_StartTime wildfire_StartTime Czas trwania
KALIFORNIA 2007-05-08 00:00:00.0000000 2007-05-08 16:02:00.0000000 16:02:00
KALIFORNIA 2007-05-08 00:00:00.0000000 2007-05-10 11:30:00.0000000 2.11:30:00
KALIFORNIA 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
TEKSAS 2007-08-10 08:00:00.0000000 2007-08-11 13:56:00.0000000 1.05:56:00
KALIFORNIA 2007-08-31 08:00:00.0000000 2007-09-01 11:28:00.0000000 1.03:28:00
KALIFORNIA 2007-08-31 08:00:00.0000000 2007-09-02 13:30:00.0000000 2.05:30:00
KALIFORNIA 2007-09-02 12:00:00.0000000 2007-09-02 13:30:00.0000000 01:30:00