Функции временных окон

Experimental feature. Learn more.

Not supported in ClickHouse Cloud

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

tumble

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

Синтаксис

Аргументы

• time_attr — Дата и время. DateTime.
• interval — Интервал окна в Interval.
• timezone — Название часового пояса (необязательно).

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

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

Пример

Запрос:

Результат:

tumbleStart

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

Синтаксис

Аргументы

• time_attr — Дата и время. DateTime.
• interval — Интервал окна в Interval.
• timezone — Название часового пояса (необязательно).

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

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

Пример

Запрос:

Результат:

tumbleEnd

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

Синтаксис

Аргументы

• time_attr — Дата и время. DateTime.
• interval — Интервал окна в Interval.
• timezone — Название часового пояса (необязательно).

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

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

Пример

Запрос:

Результат:

hop

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

Аргументы

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

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

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

примечание

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

Пример

Запрос:

Результат:

hopStart

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

Синтаксис

Аргументы

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

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

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

примечание

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

Пример

Запрос:

Результат:

hopEnd

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

Синтаксис

Аргументы

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

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

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

примечание

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

Пример

Запрос:

Результат:

Связанное содержимое

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