Saltar al contenido principal
Algunas funciones de agregación pueden aceptar no solo columnas de argumentos (usadas para la compresión), sino también un conjunto de parámetros: constantes para la inicialización. La sintaxis utiliza dos pares de paréntesis en lugar de uno. El primero es para los parámetros y el segundo, para los argumentos.

​
histograma

Calcula un histograma adaptativo. No garantiza resultados exactos.
La función usa A Streaming Parallel Decision Tree Algorithm. Los límites de los intervalos del histograma se ajustan a medida que entran nuevos datos en la función. En general, los anchos de los intervalos no son iguales. Argumentos values — Expresión que produce los valores de entrada. Parámetros number_of_bins — Límite superior del número de intervalos en el histograma. La función calcula automáticamente el número de intervalos. Intenta alcanzar el número de intervalos especificado, pero si no lo consigue, usa menos intervalos. Valores devueltos
  • Array de Tuplas con el siguiente formato:
    • lower — Límite inferior del intervalo.
    • upper — Límite superior del intervalo.
    • height — Altura calculada del intervalo.
Ejemplo
Puedes ver un histograma con la función bar, por ejemplo:
En este caso, debes recordar que no conoces los límites de los intervalos del histograma.

​
sequenceMatch

Comprueba si la secuencia contiene una cadena de eventos que coincida con el patrón. Sintaxis
Los eventos que ocurren en el mismo segundo pueden aparecer en la secuencia en un orden indefinido, lo que afecta al resultado.
Argumentos
  • timestamp — Columna que se considera que contiene marcas de tiempo. Los tipos de datos típicos son Date y DateTime. También puede usar cualquiera de los tipos de datos UInt compatibles.
  • cond1, cond2 — Condiciones que describen la cadena de eventos. Tipo de dato: UInt8. Puede pasar hasta 32 argumentos de condición. La función solo tiene en cuenta los eventos descritos en estas condiciones. Si la secuencia contiene datos que no se describen en ninguna condición, la función los omite.
Parámetros Valores devueltos
  • 1, si el patrón coincide.
  • 0, si el patrón no coincide.
Tipo: UInt8.

​
Sintaxis del patrón

  • (?N) — Coincide con el argumento de condición en la posición N. Las condiciones se numeran en el intervalo [1, 32]. Por ejemplo, (?1) coincide con el argumento pasado al parámetro cond1.
  • .* — Coincide con cualquier número de eventos. No necesita argumentos condicionales para hacer coincidir este elemento del patrón.
  • (?t operator value) — Establece el tiempo en segundos que debe separar dos eventos. Por ejemplo, el patrón (?1)(?t>1800)(?2) coincide con eventos que ocurren con más de 1800 segundos de diferencia entre sí. Entre estos eventos puede haber una cantidad arbitraria de otros eventos. Puede usar los operadores >=, >, <, <=, ==.
Ejemplos Considere los datos de la tabla t:
Realice la consulta:
La función encontró la cadena de eventos en la que el número 2 sigue al número 1. Omitió el número 3 que había entre ambos, porque ese número no está descrito como un evento. Si queremos tener en cuenta este número al buscar la cadena de eventos dada en el ejemplo, debemos definir una condición para él.
En este caso, la función no pudo encontrar la cadena de eventos que coincidiera con el patrón, porque el evento número 3 ocurrió entre 1 y 2. Si en este mismo caso comprobáramos la condición para el número 4, la secuencia coincidiría con el patrón.
Véase también

​
sequenceCount

Cuenta el número de cadenas de eventos que coinciden con el patrón. La función busca cadenas de eventos que no se solapan. Empieza a buscar la siguiente cadena después de encontrar la cadena actual.
Los eventos que ocurren en el mismo segundo pueden quedar en la secuencia en un orden no definido, lo que afecta al resultado.
Sintaxis
Argumentos
  • timestamp — Columna que se considera que contiene marcas de tiempo. Los tipos de datos típicos son Date y DateTime. También puede usar cualquiera de los tipos de datos UInt compatibles.
  • cond1, cond2 — Condiciones que describen la cadena de eventos. Tipo de dato: UInt8. Puede proporcionar hasta 32 argumentos de condición. La función solo tiene en cuenta los eventos descritos en estas condiciones. Si la secuencia contiene datos no descritos en ninguna condición, la función los omite.
Parámetros Valores devueltos
  • Número de cadenas de eventos no superpuestas que coinciden.
Tipo: UInt64. Ejemplo Considere los datos de la tabla t:
Cuenta cuántas veces aparece el número 2 después del número 1, con cualquier cantidad de otros números entre ambos:

​
sequenceMatchEvents

Devuelve las marcas temporales de los eventos de las secuencias de eventos más largas que coincidieron con el patrón.
Los eventos que ocurren en el mismo segundo pueden quedar en la secuencia en un orden indefinido, lo que afecta al resultado.
Sintaxis
Argumentos
  • timestamp — Columna que se considera que contiene datos temporales. Los tipos de datos típicos son Date y DateTime. También puede usar cualquiera de los tipos de datos UInt compatibles.
  • cond1, cond2 — Condiciones que describen la cadena de eventos. Tipo de dato: UInt8. Puede pasar hasta 32 argumentos de condición. La función solo tiene en cuenta los eventos descritos en estas condiciones. Si la secuencia contiene datos que no se describen en ninguna condición, la función los omite.
Parámetros Valores devueltos
  • Array de marcas temporales para los argumentos de condición coincidentes (?N) de la cadena de eventos. La posición en el array coincide con la posición del argumento de condición en el patrón.
Tipo: Array. Ejemplo Considere los datos de la tabla t:
Devuelve las marcas de tiempo de los eventos de la cadena más larga
Véase también

​
windowFunnel

Busca cadenas de eventos en una ventana de tiempo deslizante y calcula el número máximo de eventos ocurridos dentro de una cadena. La función opera según el siguiente algoritmo:
  • La función busca datos que cumplen la primera condición de la cadena y establece el contador de eventos en 1. Este es el momento en que comienza la ventana deslizante.
  • Si los eventos de la cadena ocurren secuencialmente dentro de la ventana, el contador se incrementa. Si la secuencia de eventos se interrumpe, el contador no se incrementa.
  • Si los datos contienen varias cadenas de eventos con distintos grados de avance, la función solo devuelve el tamaño de la cadena más larga.
Sintaxis
Argumentos
  • timestamp — Nombre de la columna que contiene la marca de tiempo. Tipos de datos admitidos: Date, DateTime y otros tipos enteros sin signo (ten en cuenta que, aunque timestamp admite el tipo UInt64, su valor no puede superar el máximo de Int64, que es 2^63 - 1).
  • cond — Condiciones o datos que describen la cadena de eventos. UInt8.
Parámetros
  • window — Longitud de la ventana deslizante; es el intervalo de tiempo entre la primera y la última condición. La unidad de window depende del propio timestamp y puede variar. Se determina mediante la expresión timestamp of cond1 <= timestamp of cond2 <= ... <= timestamp of condN <= timestamp of cond1 + window.
  • mode — Es un argumento opcional. Se puede establecer uno o varios modos.
    • 'strict_deduplication' — Si la misma condición se cumple en la secuencia de eventos, ese evento repetido interrumpe el procesamiento posterior. Nota: puede comportarse de forma inesperada si varias condiciones se cumplen para el mismo evento.
    • 'strict_order' — No permite la interposición de otros eventos. Por ejemplo, en el caso de A->B->D->C, deja de encontrar A->B->C al llegar a D, y el nivel máximo de evento es 2.
    • 'strict_increase' — Aplica las condiciones solo a eventos con marcas de tiempo estrictamente crecientes.
    • 'strict_once' — Cuenta cada evento solo una vez en la cadena, aunque cumpla la condición varias veces.
    • 'allow_reentry' — Ignora los eventos que infringen el orden estricto. Por ejemplo, en el caso de A->A->B->C, encuentra A->B->C ignorando la A redundante, y el nivel máximo de evento es 3.
Valor devuelto El número máximo de condiciones activadas consecutivas de la cadena dentro de la ventana temporal deslizante. Se analizan todas las cadenas de la selección. Tipo: Integer. Ejemplo Determina si un periodo de tiempo determinado es suficiente para que el usuario seleccione un teléfono y lo compre dos veces en la tienda en línea. Define la siguiente cadena de eventos:
  1. El usuario inició sesión en su cuenta de la tienda (eventID = 1003).
  2. El usuario busca un teléfono (eventID = 1007, product = 'phone').
  3. El usuario realizó un pedido (eventID = 1009).
  4. El usuario volvió a hacer el pedido (eventID = 1010).
Tabla de entrada:
Descubra hasta dónde pudo avanzar el usuario user_id en la cadena de eventos durante un período entre enero y febrero de 2019.
Query
Response
Ejemplo con el modo allow_reentry Este ejemplo muestra cómo funciona el modo allow_reentry con patrones de reingreso de usuarios:

​
retention

La función acepta como argumentos entre 1 y 32 condiciones de tipo UInt8 que indican si se ha cumplido una determinada condición para el evento. Se puede especificar cualquier condición como argumento (como en WHERE). Las condiciones, excepto la primera, se aplican por pares: el resultado de la segunda será verdadero si la primera y la segunda lo son; el de la tercera, si la primera y la tercera lo son; etc. Sintaxis
Argumentos
  • cond — Una expresión que devuelve un resultado UInt8 (1 o 0).
Valor devuelto Un array de 1 o 0.
  • 1 — Se cumplió la condición para el evento.
  • 0 — No se cumplió la condición para el evento.
Tipo: UInt8. Ejemplo Veamos un ejemplo del cálculo de la función retention para determinar el tráfico del sitio. 1. Cree una tabla para este ejemplo.
Query
Tabla de entrada:
Query
Response
2. Agrupe los usuarios por el ID único uid usando la función retention.
Query
Response
3. Calcule el número total de visitas al sitio por día.
Query
Response
Donde:
  • r1- el número de visitantes únicos que visitaron el sitio en 2020-01-01 (la condición cond1).
  • r2- el número de visitantes únicos que visitaron el sitio durante un período específico entre 2020-01-01 y 2020-01-02 (las condiciones cond1 y cond2).
  • r3- el número de visitantes únicos que visitaron el sitio durante un período específico en 2020-01-01 y 2020-01-03 (las condiciones cond1 y cond3).

​
uniqUpTo(N)(x)

Calcula el número de valores distintos del argumento hasta un límite especificado, N. Si el número de valores distintos del argumento es mayor que N, esta función devuelve N + 1; en caso contrario, calcula el valor exacto. Se recomienda usarla con valores pequeños de N, hasta 10. El valor máximo de N es 100. Para el estado de una función de agregación, esta función utiliza una cantidad de memoria igual a 1 + N * el tamaño en bytes de un valor. Cuando se trabaja con cadenas, esta función almacena un hash no criptográfico de 8 bytes; para las cadenas, el cálculo es aproximado. Por ejemplo, supongamos que tiene una tabla que registra cada consulta de búsqueda realizada por los usuarios en su sitio web. Cada fila de la tabla representa una única consulta de búsqueda, con columnas para el ID de usuario, la consulta de búsqueda y el timestamp de la consulta. Puede usar uniqUpTo para generar un informe que muestre solo las palabras clave que hayan generado al menos 5 usuarios únicos.
uniqUpTo(4)(UserID) calcula la cantidad de valores únicos de UserID para cada SearchPhrase, pero solo cuenta hasta 4 valores únicos. Si hay más de 4 valores únicos de UserID para un SearchPhrase, la función devuelve 5 (4 + 1). La cláusula HAVING filtra después los valores de SearchPhrase cuyo número de valores únicos de UserID es inferior a 5. Esto le dará una lista de palabras clave de búsqueda utilizadas por al menos 5 usuarios únicos.

​
sumMapFiltered

Esta función se comporta igual que sumMap, excepto que también acepta como parámetro un array de claves para filtrar. Esto puede resultar especialmente útil cuando se trabaja con una alta cardinalidad de claves. Sintaxis sumMapFiltered(keys_to_keep)(keys, values) Parámetros
  • keys_to_keep: Array de claves para filtrar.
  • keys: Array de claves.
  • values: Array de valores.
Valor devuelto
  • Devuelve una tupla de dos arrays: claves en orden y valores sumados para las claves correspondientes.
Ejemplo
Query
Query
Response

​
sumMapFilteredWithOverflow

Esta función se comporta igual que sumMap, salvo que también acepta como parámetro un array de claves por las que filtrar. Esto puede resultar especialmente útil cuando se trabaja con una cardinalidad alta de claves. Se diferencia de la función sumMapFiltered en que realiza la suma con desbordamiento; es decir, devuelve para la suma el mismo tipo de dato que el tipo de dato del argumento. Sintaxis sumMapFilteredWithOverflow(keys_to_keep)(keys, values) Parámetros
  • keys_to_keep: Array de claves por las que filtrar.
  • keys: Array de claves.
  • values: Array de valores.
Valor devuelto
  • Devuelve una tupla de dos arrays: las claves en orden y los valores sumados para las claves correspondientes.
Ejemplo En este ejemplo, creamos una tabla sum_map, insertamos algunos datos en ella y luego usamos tanto sumMapFilteredWithOverflow como sumMapFiltered, junto con la función toTypeName, para comparar el resultado. Como requests era de tipo UInt8 en la tabla creada, sumMapFiltered ha promovido el tipo de los valores sumados a UInt64 para evitar el desbordamiento, mientras que sumMapFilteredWithOverflow ha mantenido el tipo como UInt8, que no es lo bastante grande como para almacenar el resultado; es decir, se ha producido un desbordamiento.
Query
Query
Query
Response
Response

​
sequenceNextNode

Devuelve el valor del siguiente evento que coincide con una cadena de eventos. Función experimental. Para habilitarla, SET allow_experimental_funnel_functions = 1. Sintaxis
Parámetros
  • direction — Se utiliza para indicar la dirección.
    • forward — Hacia adelante.
    • backward — Hacia atrás.
  • base — Se utiliza para establecer el punto base.
    • head — Establece el punto base en el primer evento.
    • tail — Establece el punto base en el último evento.
    • first_match — Establece el punto base en el primer event1 que coincide.
    • last_match — Establece el punto base en el último event1 que coincide.
Argumentos
  • timestamp — Nombre de la columna que contiene la marca temporal. Tipos de datos compatibles: Date, DateTime y otros tipos de enteros sin signo.
  • event_column — Nombre de la columna que contiene el valor del siguiente evento que se va a devolver. Tipos de datos compatibles: String y Nullable(String).
  • base_condition — Condición que debe cumplir el punto base.
  • event1, event2, … — Condiciones que describen la cadena de eventos. UInt8.
Valores devueltos
  • event_column[next_index] — Si el patrón coincide y existe un valor siguiente.
  • NULL - Si el patrón no coincide o no existe un valor siguiente.
Tipo: Nullable(String). Ejemplo Puede utilizarse cuando los eventos son A->B->C->D->E y se desea conocer el evento que sigue a B->C, que es D. La instrucción de consulta que busca el evento que sigue a A->B:
Query
Response
Comportamiento de forward y head
Comportamiento de backward y tail
Comportamiento de forward y first_match
Comportamiento de backward y last_match
Comportamiento de base_condition
Última modificación el 19 de junio de 2026