Skip to main content

​
timeSeriesQuantileToGrid

أُضيف في: v26.9.0 دالة تجميعية تستقبل بيانات السلاسل الزمنية على هيئة أزواج من الطوابع الزمنية والقيم، وتحسب دالة PromQL quantile_over_time على شبكة زمنية منتظمة يحددها طابع زمني للبداية وطابع زمني للنهاية وخطوة. ولكل نقطة على الشبكة، تُؤخذ العينات اللازمة لحساب الكمّية من ضمن النافذة الزمنية المحددة. وتُحسب الكمّية باستخدام طريقة R-7 (الشاملة)، على غرار quantileExactInclusive. غير أن عينات NaN لا تُستبعد كما تستبعدها quantileExactInclusive، بل يُحتفظ بها وتُرتَّب قبل كل قيمة حقيقية كما في Prometheus؛ وعليه يكون وسيط النافذة [1, NaN, 2] هو 1، وتُعيد النافذة التي تكون جميع عيناتها NaN القيمة NaN. يُمرَّر مستوى الكمّية بعد العينات بوصفه الوسيطة الأخيرة: إما رقمًا واحدًا يُستخدم عند كل نقاط الشبكة، أو مصفوفة تحتوي على رقم لكل نقطة من نقاط الشبكة. ويجب أن يكون المستوى نفسه في جميع الصفوف. وكما في Prometheus، يُعيد المستوى الأقل من 0 القيمة -Inf، والمستوى الأكبر من 1 القيمة +Inf، ويُعيد المستوى NaN القيمة NaN لكل نقطة من نقاط الشبكة تحتوي نافذتها على عينات.
هذه الدالة في مرحلة المعاينة الخاصة، ويمكن تفعيلها بضبط الإعداد enable_time_series_aggregate_functions=true.
الصيغة
المعلمات
  • start_timestamp — يحدد بداية الشبكة الزمنية. يمكن أن يكون أيضًا عددًا كسريًا، أو string يحتوي على رقم أو نص تاريخ ووقت. UInt32 أو DateTime أو DateTime64 أو Float* أو Decimal* أو String
  • end_timestamp — يحدد نهاية الشبكة الزمنية. يمكن أن يكون أيضًا عددًا كسريًا، أو string يحتوي على رقم أو نص تاريخ ووقت. UInt32 أو DateTime أو DateTime64 أو Float* أو Decimal* أو String
  • grid_step — يحدد خطوة الشبكة الزمنية بالثواني. يمكن أن يكون أيضًا عددًا كسريًا، أو string يحتوي على رقم أو مدة مثل ’15s’ أو ‘1m’. UInt32 أو Float* أو Decimal* أو String
  • staleness — يحدد الحد الأقصى لـ”التقادم” بالثواني للعينات التي تؤخذ في الحسبان. نافذة التقادم فاصل زمني مفتوح من اليسار ومغلق من اليمين. يمكن أن يكون أيضًا عددًا كسريًا، أو string يحتوي على رقم أو مدة مثل ’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))
  • phi — مستوى الكمّية، ويقع عادةً ضمن النطاق [0, 1]: إما رقم واحد للشبكة بأكملها، أو مصفوفة تضم رقمًا واحدًا لكل نقطة في الشبكة. يجب أن يكون متطابقًا في جميع الصفوف. Float* أو UInt8/16/32/64 أو Int8/16/32/64 أو Array(Float*) أو Array(UInt8/16/32/64) أو Array(Int8/16/32/64)
القيمة المعادة تُعيد الكمّية phi للقيم على الشبكة المحددة. تحتوي المصفوفة المُعادة على قيمة واحدة لكل نقطة في الشبكة الزمنية. وتكون القيمة NULL إذا لم توجد أي عينات ضمن النافذة لنقطة معينة في الشبكة. Array(Nullable(Float64)) أمثلة
آخر تعديل في ١٤ أكتوبر ٢٠٢٦