Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs
49.6kGet Started

دوال النافذة الزمنية

View as MarkdownEdit this pageReport an issueSet up docs MCP
ميزة تجريبية
غير مدعوم في ClickHouse Cloud

تعيد دوال النافذة الزمنية الحد السفلي المتضمَّن والحد العلوي غير الشامل للنافذة المقابلة. فيما يلي الدوال المستخدمة للتعامل مع WindowView:

hop

أُضيف في: v21.12.0

تكون النافذة الزمنية القافزة ذات مدة ثابتة (window_interval)، وتتحرك وفق فاصل قفز محدد (hop_interval). وإذا كان hop_interval أصغر من window_interval، تصبح النوافذ القافزة متداخلة. لذلك، يمكن إسناد السجلات إلى نوافذ متعددة.

ونظرًا لأن السجل الواحد يمكن إسناده إلى عدة نوافذ قافزة، فإن الدالة لا تُرجع إلا حدّ النافذة الأولى عند استخدام الدالة 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(toDateTime('2026-01-02 03:04:05', 'UTC'), INTERVAL '1' DAY, INTERVAL '2' DAY)
('2026-01-01 00:00:00','2026-01-03 00:00:00')

hopEnd

أُضيف في: v22.1.0

يعيد الحد العلوي غير الشامل للنافذة القافزة المقابلة.

وبما أن السجل الواحد يمكن أن يُسنَد إلى عدة نوافذ قافزة، فإن الدالة لا تعيد إلا حدّ النافذة الأولى عند استخدام الدالة hop بدون WINDOW VIEW.

البنية

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

الوسيطات

  • time_attr — التاريخ والوقت. DateTime
  • hop_interval — فاصل قفز موجب. Interval
  • window_interval — فاصل نافذة موجب. Interval
  • timezone — اختياري. اسم المنطقة الزمنية. String

القيمة المُعادة

تعيد الحد العلوي غير الشامل للنافذة القافزة المقابلة. DateTime

أمثلة

نهاية النافذة القافزة

SELECT hopEnd(toDateTime('2026-01-02 03:04:05', 'UTC'), INTERVAL '1' DAY, INTERVAL '2' DAY)
2026-01-03 00:00:00

hopStart

أُضيف في: v22.1.0

تعيد الحد السفلي الشامل للنافذة القافزة المقابلة.

وبما أن السجل الواحد يمكن أن يُسنَد إلى عدة نوافذ قافزة، فإن الدالة لا تعيد إلا حد النافذة الأولى عند استخدام الدالة hop بدون WINDOW VIEW.

البنية

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

الوسيطات

  • time_attr — التاريخ والوقت. DateTime
  • hop_interval — فاصل القفز الموجب. Interval
  • window_interval — فاصل النافذة الموجب. Interval
  • timezone — اختياري. اسم المنطقة الزمنية. String

القيمة المُعادة

تعيد الحد السفلي الشامل للنافذة القافزة المقابلة. DateTime

أمثلة

بداية النافذة القافزة

SELECT hopStart(toDateTime('2026-01-02 03:04:05', 'UTC'), INTERVAL '1' DAY, INTERVAL '2' DAY)
2026-01-01 00:00:00

tumble

أُضيف في: v21.12.0

تُوزِّع النافذة الزمنية المتعاقبة السجلات على نوافذ متواصلة غير متداخلة ذات مدة ثابتة (interval).

البنية

tumble(time_attr, interval[, timezone])

الوسيطات

  • time_attr — التاريخ والوقت. DateTime
  • interval — فاصل النافذة من نوع Interval. Interval
  • timezone — اختياري. اسم المنطقة الزمنية. String

القيمة المُعادة

تعيد الحد السفلي الشامل والحد العلوي غير الشامل للنافذة المتعاقبة المقابلة. Tuple(DateTime, DateTime)

أمثلة

النافذة المتعاقبة

SELECT tumble(toDateTime('2026-01-02 03:04:05', 'UTC'), toIntervalDay('1'))
('2026-01-02 00:00:00','2026-01-03 00:00:00')

tumbleEnd

أُضيف في: v22.1.0

يعيد الحد العلوي غير الشامل للنافذة المتعاقبة المقابلة.

البنية

tumbleEnd(time_attr, interval[, timezone])

الوسيطات

  • time_attr — التاريخ والوقت. DateTime
  • interval — فاصل النافذة من نوع Interval. Interval
  • timezone — اختياري. اسم المنطقة الزمنية. String

القيمة المُعادة

يُرجِع الحدّ العلوي غير الشامل للنافذة المتعاقبة المقابلة. DateTime

أمثلة

نهاية النافذة المتعاقبة

SELECT tumbleEnd(toDateTime('2026-01-02 03:04:05', 'UTC'), toIntervalDay('1'))
2026-01-03 00:00:00

tumbleStart

أُضيف في: v22.1.0

تعيد الحدّ السفلي المتضمَّن للنافذة المتعاقبة المقابلة.

البنية

tumbleStart(time_attr, interval[, timezone])

الوسيطات

  • time_attr — التاريخ والوقت. DateTime
  • interval — فاصل النافذة من النوع Interval
  • timezone — اختياري. اسم المنطقة الزمنية. String

القيمة المُعادة

يعيد الحد السفلي الشامل للنافذة المتعاقبة المقابلة. DateTime

أمثلة

بداية النافذة المتعاقبة

SELECT tumbleStart(toDateTime('2026-01-02 03:04:05', 'UTC'), toIntervalDay('1'))
2026-01-02 00:00:00

windowID

أُضيف في: v22.1.0

تعرض هذه الدالة معرّف نافذة متعاقبة أو نافذة قافزة المقابلة. لا يمكن استخدام هذه الدالة إلا مع WINDOW VIEW.

البنية

windowID(time_attr, interval[, timezone])

الوسيطات

  • time_attr — التاريخ والوقت. DateTime
  • interval — فاصل النافذة من نوع Interval. Interval
  • timezone — اختياري. اسم المنطقة الزمنية. String

القيمة المُعادة

يُرجع معرّف النافذة المقابلة. UInt32

أمثلة

معرّف النافذة

SELECT windowID(toDateTime('2026-01-02 03:04:05', 'UTC'), toIntervalDay('1'))
1767398400

محتوى مرتبط

Navigation