Invoegtoepassing voor sequence_detect

Artikel
01/23/2024

Detecteert volgorde-exemplaren op basis van opgegeven predicaten. De invoegtoepassing wordt aangeroepen met de evaluate operator.

Syntax

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

Meer informatie over syntaxisconventies.

Parameters

Naam	Type	Vereist	Beschrijving
T	`string`	✔️	De tabellaire invoerexpressie.
TimelineColumn	`string`	✔️	De kolomverwijzing die de tijdlijn vertegenwoordigt, moet aanwezig zijn in de bronexpressie.
MaxSequenceStepWindow	`timespan`	✔️	De waarde van de maximaal toegestane periode tussen 2 opeenvolgende stappen in de reeks.
MaxSequenceSpan	`timespan`	✔️	De maximale periode voor de reeks om alle stappen te voltooien.
Expr1, Expr2, ...	`string`	✔️	De Booleaanse predicaatexpressies die de volgordestappen definiëren.
Dim1, Dim2, ...	`string`	✔️	De dimensie-expressies die worden gebruikt om reeksen te correleren.

Retouren

Retourneert één tabel waarbij elke rij in de tabel één opeenvolgend exemplaar vertegenwoordigt:

Dim1, Dim2, ...: dimensiekolommen die zijn gebruikt om reeksen te correleren.
Expr1TimelineColumn, Expr2TimelineColumn, ...: Kolommen met tijdwaarden die de tijdlijn van elke reeksstap vertegenwoordigen.
Duur: het algemene tijdvenster voor de volgorde

Voorbeelden

Met de volgende query wordt de tabel T bekeken om te zoeken naar relevante gegevens uit een opgegeven periode.

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

Storm-gebeurtenissen verkennen

De volgende query kijkt naar de tabel StormEvents (weerstatistieken voor 2007) en toont gevallen waarin de volgorde van overmatige hitte binnen 5 dagen werd gevolgd door 'Wildfire'.

De query uitvoeren

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

Uitvoer

Staat	heat_StartTime	wildfire_StartTime	Duur
CALIFORNIË	2007-05-08 00:00:00.0000000	2007-05-08 16:02:00.0000000	16:02:00
CALIFORNIË	2007-05-08 00:00:00.0000000	2007-05-10 11:30:00.0000000	2.11:30:00
CALIFORNIË	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
CALIFORNIË	2007-08-31 08:00:00.0000000	2007-09-01 11:28:00.0000000	1.03:28:00
CALIFORNIË	2007-08-31 08:00:00.0000000	2007-09-02 13:30:00.0000000	2.05:30:00
CALIFORNIË	2007-09-02 12:00:00.0000000	2007-09-02 13:30:00.0000000	01:30:00

Delen via