timeSeriesGroupArray

أُضيف في: v25.8.0

يرتّب بيانات السلاسل الزمنية حسب الطابع الزمني بترتيب تصاعدي.

إذا كانت عدة عينات تحمل الطابع الزمني نفسه، فلا يُستخدم سوى واحدة منها: العينة ذات القيمة الأكبر. تخسر قيمة NaN أمام أي قيمة أخرى، لذا لا تُستخدم قيمة NaN إلا إذا كانت جميع العينات عند هذا الطابع الزمني هي NaN.

البنية

timeSeriesGroupArray(timestamp, value)

المعاملات

timestamp — الطابع الزمني للعينة. DateTime أو UInt32 أو UInt64
value — قيمة السلاسل الزمنية المقابلة للطابع الزمني. (U)Int* أو Float* أو Decimal

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

تُرجِع مصفوفة من عناصر Tuple بالشكل (timestamp, value) مرتبة حسب الطابع الزمني ترتيبًا تصاعديًا. Array(Tuple(T1, T2))

أمثلة

الاستخدام الأساسي مع القيم الفردية

SET allow_experimental_time_series_aggregate_functions = 1;
WITH
    [110, 120, 130, 140, 140, 100]::Array(UInt32) AS timestamps,
    [1, 6, 8, 17, 19, 5]::Array(Float32) AS values
SELECT timeSeriesGroupArray(timestamp, value)
FROM
(
    SELECT
        arrayJoin(arrayZip(timestamps, values)) AS ts_and_val,
        ts_and_val.1 AS timestamp,
        ts_and_val.2 AS value
);

┌─timeSeriesGroupArray(timestamp, value)─────┐
│ [(100,5),(110,1),(120,6),(130,8),(140,19)] │
└────────────────────────────────────────────┘

تمرير عينات متعددة من الطوابع الزمنية والقيم في صورة مصفوفات متساوية الحجم

SET allow_experimental_time_series_aggregate_functions = 1;
WITH
    [110, 120, 130, 140, 140, 100]::Array(UInt32) AS timestamps,
    [1, 6, 8, 17, 19, 5]::Array(Float32) AS values
SELECT timeSeriesGroupArray(timestamps, values);

┌─timeSeriesGroupArray(timestamps, values)───┐
│ [(100,5),(110,1),(120,6),(130,8),(140,19)] │
└────────────────────────────────────────────┘