البنية
المعاملات
db_name- اسم قاعدة البيانات التي يوجد فيها جدول TimeSeries.time_series_table- اسم جدول TimeSeries.promql_query- استعلام مكتوب بصياغة PromQL.start_time- وقت بداية نطاق التقييم.end_time- وقت نهاية نطاق التقييم.step- الخطوة المستخدَمة للتنقّل عبر وقت التقييم منstart_timeإلىend_time(شاملاً).
القيمة المُعادة
يمكن أن تُرجِع الدالة أعمدة مختلفة بناءً على نوع نتيجة الاستعلام المُمرَّر إلى المَعلمةpromql_query:
يُسمّى العمود
samples باسم time_series إذا كان جدول TimeSeries من version 2 أو أقدم.
الميزات المدعومة في PromQL
المحددات
المحددات اللحظية، ومحددات النطاق، ومطابقات الوسوم (=, !=, =~, !~)، ومُعدِّلات الإزاحة، ومُعدِّلات الطابع الزمني @، والاستعلامات الفرعية.
الدوال
ملاحظة: تستخدم
histogram_quantile الاستيفاء الخطي على حاويات المُدرَّج التكراري التقليدية (التي يحدّدها الوسم le). المُدرَّجات التكرارية الأصلية غير مدعومة. يجب أن تكون قيمة الوسيط phi (مستوى الكوانتايل) قيمة scalar ثابتة. تُرفَض التعبيرات التي تتغيّر في كل خطوة، مثل histogram_quantile(time() / 1000, ...)، مع ظهور استثناء NOT_IMPLEMENTED.
ملاحظة: الدالتان ts_of_min_over_time وts_of_max_over_time تجريبيتان في Prometheus (تُفعَّلان هناك باستخدام --enable-feature=promql-experimental-functions)؛ ويقيّمهما ClickHouse دون اشتراط هذا الخيار.
العوامل
العوامل الثنائية الحسابية (+, -, *, /, %, ^, atan2) وعوامل المقارنة (==, !=, <, >, <=, >= مع bool اختياري)، مع المعدِّلات on()/ignoring() وgroup_left()/group_right().
عوامل المجموعات المنطقية and وor وunless، مع المعدِّلات on()/ignoring().
العاملان الأحاديان + و-.
عوامل التجميع
sum, avg, min, max, count, count_values, stddev, stdvar, group, quantile, topk, bottomk, limitk — مع معدِّلات اختيارية by() أو without().
غير مدعوم حاليًا
- دوال النطاق
stddev_over_time،stdvar_over_time،mad_over_time،first_over_time،ts_of_last_over_time،ts_of_first_over_time