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

توثيق دوال النافذة الزمنية

تعيد دوال النافذة الزمنية الحد السفلي المتضمَّن والحد العلوي غير المتضمَّن للنافذة المقابلة. فيما يلي الدوال المستخدمة للتعامل مع 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)

أمثلة

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

Query

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

Response

('2024-07-03 00:00:00','2024-07-05 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

أمثلة

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

Query

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

Response

2024-07-05 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

أمثلة

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

Query

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

Response

2024-07-03 00:00:00

​

tumble

قُدِّمت في: v21.12.0

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

البنية

tumble(time_attr, interval[, timezone])

الوسيطات

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

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

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

أمثلة

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

Query

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

Response

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

​

tumbleEnd

أُضيف في: v22.1.0

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

الصياغة

tumbleEnd(time_attr, interval[, timezone])

المعاملات

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

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

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

أمثلة

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

Query

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

Response

2024-07-05 00:00:00

​

tumbleStart

قُدِّمت في: v22.1.0

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

البنية

tumbleStart(time_attr, interval[, timezone])

المعاملات

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

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

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

أمثلة

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

Query

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

Response

2024-07-04 00:00:00

​

windowID

أُضيف في: v22.1.0

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

الصياغة

windowID(time_attr, interval[, timezone])

الوسائط

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

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

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

أمثلة

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

Query

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

Response

​

محتوى مرتبط

• أدلة حالات استخدام السلاسل الزمنية