sequence_detect, plug-in

Article
11/23/2024

S’applique à : ✅Microsoft Fabric ✅Azure Data Explorer

Détecte les occurrences de séquence en fonction des prédicats fournis. Le plug-in est appelé avec l’opérateur evaluate .

Syntaxe

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

En savoir plus sur les conventions de syntaxe.

Paramètres

Nom	Type	Requise	Description
T	`string`	✔️	Expression tabulaire d’entrée.
TimelineColumn	`string`	✔️	La référence de colonne représentant la chronologie doit être présente dans l’expression source.
MaxSequenceStepWindow	`timespan`	✔️	Valeur de l’intervalle de temps maximal autorisé entre 2 étapes séquentielles dans la séquence.
MaxSequenceSpan	`timespan`	✔️	Intervalle maximal de temps pour la séquence pour effectuer toutes les étapes.
Expr1, Expr2, ...	`string`	✔️	Expressions de prédicat booléenne définissant les étapes de séquence.
Dim1, Dim2, ...	`string`	✔️	Expressions de dimension utilisées pour mettre en corrélation des séquences.

Retours

Retourne une table unique où chaque ligne de la table représente une occurrence de séquence unique :

Dim1, Dim2, ... : colonnes de dimension utilisées pour mettre en corrélation des séquences.
Expr1TimelineColumn, Expr2TimelineColumn, ... : Colonnes avec valeurs de temps, représentant la chronologie de chaque étape de séquence.
Durée : fenêtre de temps de séquence globale

Exemples

La requête suivante examine la table T pour rechercher des données pertinentes à partir d’une période spécifiée.

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

Exploration des événements Storm

La requête suivante examine la table StormEvents (statistiques météorologiques pour 2007) et montre les cas où la séquence de « chaleur excessive » a été suivie de « Feu excessif » dans les 5 jours.

Exécuter la requête

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

Sortie

State	heat_StartTime	wildfire_StartTime	Durée
CALIFORNIE	2007-05-08 00:00:00.0000000	2007-05-08 16:02:00.0000000	16:02:00
CALIFORNIE	2007-05-08 00:00:00.0000000	2007-05-10 11:30:00.0000000	2.11:30:00
CALIFORNIE	2007-07-04 09:00:00.0000000	2007-07-05 23:01:00.0000000	1.14:01:00
DAKOTA DU SUD	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
CALIFORNIE	2007-08-31 08:00:00.0000000	2007-09-01 11:28:00.0000000	1.03:28:00
CALIFORNIE	2007-08-31 08:00:00.0000000	2007-09-02 13:30:00.0000000	2.05:30:00
CALIFORNIE	2007-09-02 12:00:00.0000000	2007-09-02 13:30:00.0000000	01:30:00

Partager via