時間ウィンドウ関数

Experimental feature. Learn more.

Not supported in ClickHouse Cloud

時間ウィンドウ関数は、対応するウィンドウの包含下限および排他上限を返します。WindowViewを操作するための関数は以下にリストされています。

tumble

タンブリング時間ウィンドウは、重複しない連続したウィンドウにレコードを割り当て、固定の期間（interval）を持ちます。

構文

引数

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

戻り値

• 対応するタンブリングウィンドウの包含下限および排他上限。Tuple(DateTime, DateTime)。

例

クエリ：

結果：

tumbleStart

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

構文

引数

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

戻り値

• 対応するタンブリングウィンドウの包含下限。DateTime、TupleまたはUInt32。

例

クエリ：

結果：

tumbleEnd

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

構文

引数

• 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)。

注記

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

例

クエリ：

結果：

hopStart

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

構文

引数

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

戻り値

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

注記

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

例

クエリ：

結果：

hopEnd

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

構文

引数

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

戻り値

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

注記

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

例

クエリ：

結果：

関連コンテンツ

• ブログ: ClickHouseでの時系列データの操作