Plug-In „sequence_detect“

Artikel
11/23/2024

Gilt für: ✅Microsoft Fabric ✅Azure Data Explorer

Erkennt Sequenzvorkommnisse basierend auf bereitgestellten Prädikaten. Das Plug-In wird mit dem evaluate Operator aufgerufen.

Syntax

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

Erfahren Sie mehr über Syntaxkonventionen.

Parameter

Name	Type	Erforderlich	Beschreibung
T	`string`	✔️	Der Tabellarische Eingabeausdruck.
TimelineColumn	`string`	✔️	Der Spaltenverweis, der die Zeitachse darstellt, muss im Quellausdruck vorhanden sein.
MaxSequenceStepWindow	`timespan`	✔️	Der Wert des maximal zulässigen Zeitbereichs zwischen zwei sequenziellen Schritten in der Sequenz.
MaxSequenceSpan	`timespan`	✔️	Der maximale Zeitbereich für die Sequenz, um alle Schritte auszuführen.
Ausdruck1, Ausdruck2, ...	`string`	✔️	Die booleschen Prädikatausdrücke, die Sequenzschritte definieren.
Dim1, Dim2, ...	`string`	✔️	Die Bemaßungsausdrücke, die zum Korrelieren von Sequenzen verwendet werden.

Gibt zurück

Gibt eine einzelne Tabelle zurück, in der jede Zeile in der Tabelle ein einzelnes Sequenzelement darstellt:

Dim1, Dim2, ...: Dimensionsspalten, die zum Korrelieren von Sequenzen verwendet wurden.
Expr1TimelineColumn, Expr2TimelineColumn, ...: Spalten mit Zeitwerten, die die Zeitachse der einzelnen Sequenzschritte darstellen.
Dauer: Das Gesamtzeitfenster der Sequenz

Beispiele

Die folgende Abfrage untersucht die Tabelle T, um nach relevanten Daten aus einem bestimmten Zeitraum zu suchen.

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

Erkunden von Sturmereignissen

Die folgende Abfrage sucht nach der Tabelle StormEvents (Wetterstatistik für 2007) und zeigt Fälle an, in denen die Sequenz von "Übermäßige Hitze" innerhalb von 5 Tagen von "Wildfire" gefolgt wurde.

Abfrage ausführen

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

Ausgabe

State	heat_StartTime	wildfire_StartTime	Duration
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

Freigeben über