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 |