Оконные функции времени

Experimental feature. Learn more.

Not supported in ClickHouse Cloud

Оконные функции времени возвращают включительные нижние и исключительные верхние границы соответствующего окна. Функции для работы с WindowView перечислены ниже:

tumble

Функция tumble назначает записи невзаимоперекрывающимся, непрерывным окнам с фиксированной длительностью (interval).

Синтаксис

Аргументы

• time_attr — Дата и время. DateTime.
• interval — Интервал окна в Interval.
• timezone — Имя временной зоны (необязательно).

Возвращаемые значения

• Включительная нижняя и исключительная верхняя граница соответствующего окна tumble. Tuple(DateTime, DateTime).

Пример

Запрос:

Результат:

tumbleStart

Возвращает включительную нижнюю границу соответствующего tumbling window.

Синтаксис

Аргументы

• time_attr — Дата и время. DateTime.
• interval — Интервал окна в Interval.
• timezone — Имя временной зоны (необязательно).

Возвращаемые значения

• Включительная нижняя граница соответствующего окна tumble. DateTime, Tuple или UInt32.

Пример

Запрос:

Результат:

tumbleEnd

Возвращает исключительную верхнюю границу соответствующего tumbling window.

Синтаксис

Аргументы

• time_attr — Дата и время. DateTime.
• interval — Интервал окна в Interval.
• timezone — Имя временной зоны (необязательно).

Возвращаемые значения

• Исключительная верхняя граница соответствующего окна tumble. DateTime, Tuple или UInt32.

Пример

Запрос:

Результат:

hop

Функция hop имеет фиксированную длительность (window_interval) и перемещается с указанным интервалом (hop_interval). Если hop_interval меньше window_interval, окна будут перекрываться. Таким образом, записи могут быть назначены нескольким окнам.

Аргументы

• time_attr — Дата и время. DateTime.
• hop_interval — Положительный интервал перемещения. Interval.
• window_interval — Положительный интервал окна. Interval.
• timezone — Имя временной зоны (необязательно).

Возвращаемые значения

• Включительная нижняя и исключительная верхняя граница соответствующего окна hop. Tuple(DateTime, DateTime)`.

примечание

Поскольку одна запись может быть назначена нескольким окнам hop, функция возвращает границу только первого окна, когда функция hop используется без WINDOW VIEW.

Пример

Запрос:

Результат:

hopStart

Возвращает включительную нижнюю границу соответствующего hopping window.

Синтаксис

Аргументы

• time_attr — Дата и время. DateTime.
• hop_interval — Положительный интервал перемещения. Interval.
• window_interval — Положительный интервал окна. Interval.
• timezone — Имя временной зоны (необязательно).

Возвращаемые значения

• Включительная нижняя граница соответствующего окна hop. DateTime, Tuple или UInt32.

примечание

Поскольку одна запись может быть назначена нескольким окнам hop, функция возвращает границу только первого окна, когда функция hop используется без WINDOW VIEW.

Пример

Запрос:

Результат:

hopEnd

Возвращает исключительную верхнюю границу соответствующего hopping window.

Синтаксис

Аргументы

• time_attr — Дата и время. DateTime.
• hop_interval — Положительный интервал перемещения. Interval.
• window_interval — Положительный интервал окна. Interval.
• timezone — Имя временной зоны (необязательно).

Возвращаемые значения

• Исключительная верхняя граница соответствующего окна hop. DateTime, Tuple или UInt32.

примечание

Поскольку одна запись может быть назначена нескольким окнам hop, функция возвращает границу только первого окна, когда функция hop используется без WINDOW VIEW.

Пример

Запрос:

Результат:

Связанный контент

• Блог: Работа с данными временных рядов в ClickHouse