Complemento sequence_detect

Artículo
01/18/2024

Detecta repeticiones de secuencia basadas en predicados proporcionados. El complemento se invoca con el evaluate operador .

Syntax

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

Obtenga más información sobre las convenciones de sintaxis.

Parámetros

Nombre	Tipo	Requerido	Descripción
T	`string`	✔️	Expresión tabular de entrada.
TimelineColumn	`string`	✔️	La referencia de columna que representa la escala de tiempo debe estar presente en la expresión de origen.
MaxSequenceStepWindow	`timespan`	✔️	Valor del intervalo de tiempo máximo permitido entre 2 pasos secuenciales en la secuencia.
MaxSequenceSpan	`timespan`	✔️	Intervalo máximo de tiempo de la secuencia para completar todos los pasos.
Expr1, Expr2, ...	`string`	✔️	Expresiones de predicado booleanas que definen los pasos de secuencia.
Dim1, Dim2, ...	`string`	✔️	Expresiones de dimensión que se usan para correlacionar secuencias.

Devoluciones

Devuelve una sola tabla donde cada fila de la tabla representa una sola repetición de secuencia:

Dim1, Dim2, ...: columnas de dimensión que se usaron para correlacionar secuencias.
Expr1TimelineColumn, Expr2TimelineColumn, ...: Columnas con valores de hora, que representan la escala de tiempo de cada paso de secuencia.
Duración: la ventana de tiempo de secuencia general

Ejemplos

La consulta siguiente examina la tabla T para buscar datos relevantes a partir de un período de tiempo especificado.

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

Exploración de eventos de Storm

La consulta siguiente busca en la tabla StormEvents (estadísticas meteorológicas de 2007) y muestra los casos en los que la secuencia de "Calor excesivo" fue seguida de "Fuego Intemperie" en un plazo de 5 días.

Ejecución de la consulta

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

Salida

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
DAKOTA DEL SUR	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

Share via