時間ウィンドウ関数

Experimental feature. Learn more.

Not supported in ClickHouse Cloud

時間ウィンドウ関数は、対応するウィンドウの下限（含む）と上限（含まない）を返します。 WindowView を扱うための関数は次のとおりです。

hop

導入バージョン: v21.12

ホップ型時間ウィンドウは固定の長さ（window_interval）を持ち、指定されたホップ間隔（hop_interval）ごとにシフトします。hop_interval が window_interval より小さい場合、ホップウィンドウは互いに重なります。このため、レコードは複数のウィンドウに割り当てられる可能性があります。

1 つのレコードが複数の hop ウィンドウに割り当てられる可能性があるため、hop 関数が WINDOW VIEW なしで使用される場合、この関数は最初のウィンドウの境界のみを返します。

構文

hop(time_attr, hop_interval, window_interval[, timezone])

引数

• time_attr — 日付と時刻。DateTime
• hop_interval — 正のホップ間隔。Interval
• window_interval — 正のウィンドウ間隔。Interval
• timezone — 省略可能。タイムゾーン名。String

戻り値

対応するホッピングウィンドウの下限値（以上）と上限値（未満）を返します。Tuple(DateTime, DateTime)

例

ホッピングウィンドウ

SELECT hop(now(), INTERVAL '1' DAY, INTERVAL '2' DAY)

('2024-07-03 00:00:00','2024-07-05 00:00:00')

hopEnd

導入バージョン: v22.1

対応する hop window の排他的上限を返します。

1 つのレコードは複数の hop window に割り当てられる可能性があるため、WINDOW VIEW を使用せずに hop 関数を使った場合、この関数は最初のウィンドウの上限のみを返します。

構文

hopEnd(time_attr, hop_interval, window_interval[, timezone])

引数

• time_attr — 日付と時刻。DateTime
• hop_interval — 正のホップ間隔。Interval
• window_interval — 正のウィンドウ間隔。Interval
• timezone — 省略可能。タイムゾーン名。String

返り値

対応するホッピングウィンドウの排他的な上限時刻を返します。DateTime

使用例

ホッピングウィンドウの終了

SELECT hopEnd(now(), INTERVAL '1' DAY, INTERVAL '2' DAY)

2024-07-05 00:00:00

hopStart

導入バージョン: v22.1

対応するホップウィンドウの含まれる側の下限値を返します。

1 つのレコードは複数のホップウィンドウに割り当てられる可能性があるため、WINDOW VIEW を使用せずに hop 関数を使用した場合、この関数は最初のウィンドウの下限のみを返します。

構文

hopStart(time_attr, hop_interval, window_interval[, timezone])

引数

• time_attr — 日付と時刻。DateTime
• hop_interval — 正のホップ間隔。Interval
• window_interval — 正のウィンドウ間隔。Interval
• timezone — 省略可能。タイムゾーン名。String

返り値

対応するホッピングウィンドウの包含的な下限値を返します。DateTime

使用例

ホッピングウィンドウの開始時刻

SELECT hopStart(now(), INTERVAL '1' DAY, INTERVAL '2' DAY)

2024-07-03 00:00:00

tumble

導入バージョン: v21.12

tumbling time window は、固定長の期間（interval）で構成される、互いに重ならない連続ウィンドウにレコードを割り当てます。

構文

tumble(time_attr, interval[, timezone])

引数

• time_attr — 日付と時刻。DateTime
• interval — Interval 型で指定するウィンドウ間隔。Interval
• timezone — 省略可能。タイムゾーン名。String

戻り値

対応するタンブリングウィンドウの下限（含む）と上限（含まない）の境界を返します。Tuple(DateTime, DateTime)

使用例

タンブリングウィンドウ

SELECT tumble(now(), toIntervalDay('1'))

('2024-07-04 00:00:00','2024-07-05 00:00:00')

tumbleEnd

導入バージョン: v22.1

対応するタンブリングウィンドウの排他的上限値を返します。

構文

tumbleEnd(time_attr, interval[, timezone])

引数

• time_attr — 日付と時刻。DateTime
• interval — ウィンドウの間隔を表す Interval 型。Interval
• timezone — 省略可能。タイムゾーン名。String

戻り値

対応するタンブリングウィンドウの排他的な上限値を返します。DateTime

使用例

タンブリングウィンドウの終了時刻

SELECT tumbleEnd(now(), toIntervalDay('1'))

2024-07-05 00:00:00

tumbleStart

導入バージョン: v22.1

対応するタンブリングウィンドウの含まれる下限値（開始時刻）を返します。

構文

tumbleStart(time_attr, interval[, timezone])

引数

• time_attr — 日付と時刻。DateTime
• interval — Interval 型で指定するウィンドウ間隔。Interval
• timezone — 任意。タイムゾーン名。String

戻り値

対応するタンブリングウィンドウの下限（包含側の端）を返します。DateTime

例

タンブリングウィンドウの開始時刻

SELECT tumbleStart(now(), toIntervalDay('1'))

2024-07-04 00:00:00

windowID

導入バージョン: v22.1

対応するタンブリングウィンドウまたはホッピングウィンドウのウィンドウ識別子を返します。 この関数は WINDOW VIEW でのみ使用できます。

構文

windowID(time_attr, interval[, timezone])

引数

• time_attr — 日付と時刻。DateTime
• interval — ウィンドウの間隔を表す Interval 型。Interval
• timezone — 省略可能。タイムゾーン名。String

戻り値

対応するウィンドウの識別子を返します。UInt32

使用例

ウィンドウ ID

SELECT windowID(now(), toIntervalDay('1'))

関連コンテンツ

• 時系列ユースケースガイド