timeSeriesDeltaToGrid
أُضيف في: v25.6.0 دالة تجميع تأخذ بيانات السلاسل الزمنية على هيئة أزواج من الطوابع الزمنية والقيم، وتحسب دلتا بأسلوب مشابه لـ PromQL من هذه البيانات على شبكة زمنية منتظمة يحددها الطابع الزمني للبداية، والطابع الزمني للنهاية، والخطوة. وبالنسبة إلى كل نقطة على الشبكة، تُؤخذ العينات المستخدمة في حسابdelta ضمن النافذة الزمنية المحددة.
يمكن تمرير العينات بإحدى الصيغ الثلاث التالية:
- كوسيطتين هما
timestampوvalue، حيث يحتوي كل صف على عينة واحدة؛ - كمصفوفتين من الطوابع الزمنية والقيم، حيث يحتوي كل صف على سلسلة زمنية كاملة؛
- كمصفوفة واحدة من الأزواج المرتبة
(timestamp, value)، حيث يحتوي كل صف على سلسلة زمنية كاملة.
start_timestamp— يحدّد بداية الشبكة. مع وسيطة طابع زمني من نوعDateTime64، يمكن أن يكون أيضًا رقمًا كسريًا، أو سلسلة تحتوي على رقم أو نص تاريخ ووقت.UInt32أوDateTimeأوDateTime64أوFloat*أوDecimal*أوStringend_timestamp— يحدّد نهاية الشبكة. مع وسيطة طابع زمني من نوعDateTime64، يمكن أن يكون أيضًا رقمًا كسريًا، أو سلسلة تحتوي على رقم أو نص تاريخ ووقت.UInt32أوDateTimeأوDateTime64أوFloat*أوDecimal*أوStringgrid_step— يحدّد خطوة الشبكة بالثواني. مع وسيطة طابع زمني من نوعDateTime64، يمكن أن يكون أيضًا رقمًا كسريًا، أو سلسلة تحتوي على رقم أو مدة مثل ’15s’ أو ‘1m’.UInt32أوFloat*أوDecimal*أوStringstaleness— يحدّد الحد الأقصى للتقادم، بالثواني، للعينات التي تؤخذ في الحسبان. نافذة التقادم هي فترة مفتوحة من اليسار ومغلقة من اليمين. مع وسيطة طابع زمني من نوعDateTime64، يمكن أن يكون أيضًا رقمًا كسريًا، أو سلسلة تحتوي على رقم أو مدة مثل ’15s’ أو ‘1m’.UInt32أوFloat*أوDecimal*أوString
timestamp— الطابع الزمني للعينة. يمكن أن يكون قيمة مفردة أو مصفوفة.UInt32أوDateTimeأوDateTime64أوArray(UInt32)أوArray(DateTime)أوArray(DateTime64)value— قيمة السلسلة الزمنية المقابلة للطابع الزمني. يمكن أن تكون قيمة مفردة أو مصفوفة.Float*أوArray(Float*)samples— عينات السلسلة الزمنية المُمرَّرة كمصفوفة من الصفوف(timestamp, value)، حيث تكون لعناصر الصف أنواع الطابع الزمني والقيمة المذكورة أعلاه. بديل لتمرير الطوابع الزمنية والقيم كوسيطتين منفصلتين.Array(Tuple(T1, T2))
Array(Nullable(Float64))
أمثلة
الاستخدام الأساسي مع أزواج فردية من الطابع الزمني والقيمة
Query
Response
Query
Response