時間ウィンドウ関数

Experimental feature. Learn more.

Not supported in ClickHouse Cloud

時間ウィンドウ関数は、対応するウィンドウの包含的下限と排他的上限を返します。WindowViewで作業するための関数は以下に示されています。

tumble

チューニング時間ウィンドウは、到達的で連続したウィンドウにレコードを割り当て、固定の期間（interval）を持ちます。

構文

引数

• time_attr — 日付と時刻。DateTime。
• interval — ウィンドウインターバルのInterval。
• timezone — タイムゾーン名（オプション）。

返される値

• 対応するチューニングウィンドウの包含的下限と排他的上限。タプル(DateTime, DateTime)。

例

クエリ:

結果:

tumbleStart

対応するtumbling windowの包含的下限を返します。

構文

引数

• time_attr — 日付と時刻。DateTime。
• interval — ウィンドウインターバルのInterval。
• timezone — タイムゾーン名（オプション）。

返される値

• 対応するチューニングウィンドウの包含的下限。DateTime、タプルまたはUInt32。

例

クエリ:

結果:

tumbleEnd

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

構文

引数

• time_attr — 日付と時刻。DateTime。
• interval — ウィンドウインターバルのInterval。
• timezone — タイムゾーン名（オプション）。

返される値

• 対応するチューニングウィンドウの包含的下限。DateTime、タプルまたはUInt32。

例

クエリ:

結果:

hop

ホッピング時間ウィンドウは固定の期間（window_interval）を持ち、指定されたホップ間隔（hop_interval）によってホップします。hop_intervalがwindow_intervalより小さい場合、ホッピングウィンドウは重複します。したがって、レコードは複数のウィンドウに割り当てられることがあります。

引数

• time_attr — 日付と時刻。DateTime。
• hop_interval — 正のホップ間隔。Interval。
• window_interval — 正のウィンドウ間隔。Interval。
• timezone — タイムゾーン名（オプション）。

返される値

• 対応するホッピングウィンドウの包含的下限と排他的上限。タプル(DateTime, DateTime)。

注記

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

例

クエリ:

結果:

hopStart

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

構文

引数

• time_attr — 日付と時刻。DateTime。
• hop_interval — 正のホップ間隔。Interval。
• window_interval — 正のウィンドウ間隔。Interval。
• timezone — タイムゾーン名（オプション）。

返される値

• 対応するホッピングウィンドウの包含的下限。DateTime、タプルまたはUInt32。

注記

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

例

クエリ:

結果:

hopEnd

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

構文

引数

• time_attr — 日付と時刻。DateTime。
• hop_interval — 正のホップ間隔。Interval。
• window_interval — 正のウィンドウ間隔。Interval。
• timezone — タイムゾーン名（オプション）。

返される値

• 対応するホッピングウィンドウの排他的上限。DateTime、タプルまたはUInt32。

注記

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

例

クエリ:

結果:

関連コンテンツ

• Blog: ClickHouseでの時系列データの操作