Skip to main content

timeSeriesInstantRateToGrid

أُضيفت في: v25.6.0 دالة تجميع تأخذ بيانات السلاسل الزمنية على هيئة أزواج من الطوابع الزمنية والقيم، وتحسب irate على غرار PromQL من هذه البيانات على شبكة زمنية منتظمة يحددها الطابع الزمني للبداية والطابع الزمني للنهاية وstep. ولكل نقطة على الشبكة، تُؤخذ العينات المستخدمة في حساب irate ضمن النافذة الزمنية المحددة. يمكن تمرير العينات بإحدى ثلاث صور:
  • على هيئة وسيطتين timestamp وvalue، حيث يحتوي كل صف على عينة واحدة؛
  • على هيئة مصفوفتين من الطوابع الزمنية والقيم، حيث يحتوي كل صف على سلسلة زمنية كاملة؛
  • على هيئة مصفوفة واحدة من الأزواج (timestamp, value)، حيث يحتوي كل صف على سلسلة زمنية كاملة.
إذا كانت عدة عينات تحمل الطابع الزمني نفسه، فلا تُستخدم سوى واحدة منها: العينة ذات القيمة الأكبر. وتُستبدل قيمة NaN بأي قيمة أخرى، لذا لا تُستخدم قيمة NaN إلا إذا كانت جميع العينات عند هذا الطابع الزمني NaN.
هذه الدالة في المعاينة الخاصة، ويمكنك تفعيلها بضبط enable_time_series_aggregate_functions=true.
الصياغة
المعلمات
  • start_timestamp — يحدّد بداية الشبكة. مع وسيطة طابع زمني من نوع DateTime64، يمكن أن يكون أيضاً رقماً كسرياً أو سلسلة تحتوي على رقم أو نص تاريخ ووقت. UInt32 أو DateTime أو DateTime64 أو Float* أو Decimal* أو String
  • end_timestamp — يحدّد نهاية الشبكة. مع وسيطة طابع زمني من نوع DateTime64، يمكن أن يكون أيضاً رقماً كسرياً أو سلسلة تحتوي على رقم أو نص تاريخ ووقت. UInt32 أو DateTime أو DateTime64 أو Float* أو Decimal* أو String
  • grid_step — يحدّد خطوة الشبكة بالثواني. مع وسيطة طابع زمني من نوع DateTime64، يمكن أن يكون أيضاً رقماً كسرياً أو سلسلة تحتوي على رقم أو مدة مثل ’15s’ أو ‘1m’. UInt32 أو Float* أو Decimal* أو String
  • staleness — يحدّد الحد الأقصى للتقادم، بالثواني، للعينات التي تؤخذ في الاعتبار. نافذة التقادم هي فترة مفتوحة من اليسار ومغلقة من اليمين. مع وسيطة طابع زمني من نوع 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))
القيمة المُعادة تُعيد قيم irate على الشبكة المحددة. تحتوي المصفوفة المُعادة على قيمة واحدة لكل نقطة في الشبكة الزمنية. تكون القيمة NULL إذا لم تكن هناك عينات كافية داخل النافذة لحساب قيمة المعدل اللحظي لنقطة شبكة معيّنة. Array(Nullable(Float64)) أمثلة الاستخدام الأساسي مع أزواج timestamp-value فردية
Query
Response
استخدام وسيطات من نوع Array
Query
Response
آخر تعديل في ٢٦ سبتمبر ٢٠٢٦