prometheusQueryRange

يُقيِّم استعلام Prometheus باستخدام بيانات من جدول TimeSeries عبر نطاق من أزمنة التقييم.

البنية

prometheusQueryRange('db_name', 'time_series_table', 'promql_query', start_time, end_time, step)
prometheusQueryRange(db_name.time_series_table, 'promql_query', start_time, end_time, step)
prometheusQueryRange('time_series_table', 'promql_query', start_time, end_time, step)

المعاملات

db_name - اسم قاعدة البيانات التي يوجد فيها جدول TimeSeries.
time_series_table - اسم جدول TimeSeries.
promql_query - استعلام مكتوب بصياغة PromQL.
start_time - وقت بداية نطاق التقييم، بدقة المللي ثانية أو أدق.
end_time - وقت نهاية نطاق التقييم، بدقة المللي ثانية أو أدق.
step - الخطوة المستخدَمة للتنقّل عبر وقت التقييم من start_time إلى end_time (شاملاً).

قيمة معادة

تُعيد الدالة أعمدة مختلفة تبعًا لنوع نتيجة الاستعلام المُمرَّر عبر المعلمة promql_query:

نوع النتيجة	أعمدة النتيجة	مثال
vector	tags Array(Tuple(String, String)), timestamp DateTime64(S, TZ), value Float64	prometheusQuery(mytable, ‘up’)
matrix	tags Array(Tuple(String, String)), samples Array(Tuple(DateTime64(S, TZ), Float64))	prometheusQuery(mytable, ‘up[1m]‘)
scalar	timestamp DateTime64(S, TZ), value Float64	prometheusQuery(mytable, ‘1h30m’)
string	timestamp DateTime64(S, TZ), value String	prometheusQuery(mytable, ‘“abc”’)

تكون القيم دائمًا من النوع Float64، بغضّ النظر عن نوعها في جدول TimeSeries. وتطابق دقة الطوابع الزمنية S دقتها في الجدول، على ألا تقل عن 3 (مللي ثانية). أما المنطقة الزمنية TZ، فتطابق المنطقة الزمنية لـstart_time وend_time إذا كانا من النوع DateTime أو DateTime64 ولهما المنطقة الزمنية نفسها؛ وإلا فتطابق المنطقة الزمنية للطوابع الزمنية في الجدول. يكون اسم العمود samples هو time_series إذا كان إصدار جدول TimeSeries هو 2 أو أقدم.

الميزات المدعومة في PromQL

المحددات

المحددات اللحظية، ومحددات النطاق، ومطابقات الوسوم (=, !=, =~, !~)، ومُعدِّلات الإزاحة، ومُعدِّلات الطابع الزمني @، والاستعلامات الفرعية.

الدوال

الفئة	الدوال
النطاق	`rate`, `irate`, `delta`, `idelta`, `increase`, `last_over_time`, `first_over_time`, `sum_over_time`, `avg_over_time`, `count_over_time`, `max_over_time`, `min_over_time`, `ts_of_max_over_time`, `ts_of_min_over_time`, `ts_of_last_over_time`, `ts_of_first_over_time`, `deriv`, `changes`, `resets`, `present_over_time`, `absent_over_time`, `quantile_over_time`, `stddev_over_time`, `stdvar_over_time`, `mad_over_time`, `predict_linear`
الرياضيات	`abs`, `sgn`, `floor`, `ceil`, `sqrt`, `exp`, `ln`, `log2`, `log10`, `rad`, `deg`, `round`, `clamp`, `clamp_min`, `clamp_max`, `min_of`, `max_of`
حساب المثلثات	`sin`, `cos`, `tan`, `asin`, `acos`, `atan`, `sinh`, `cosh`, `tanh`, `asinh`, `acosh`, `atanh`
DateTime	`day_of_week`, `day_of_month`, `days_in_month`, `day_of_year`, `minute`, `hour`, `month`, `year`
الوسم	`label_replace`, `label_join`
نوع	`scalar`, `vector`
مُدرَّج تكراري	`histogram_quantile`
أخرى	`time`, `pi`, `absent`, `timestamp`

ملاحظة: تستخدم histogram_quantile الاستيفاء الخطي على حاويات المُدرَّج التكراري التقليدية (التي يحدّدها الوسم le). المُدرَّجات التكرارية الأصلية غير مدعومة. يجب أن تكون قيمة الوسيطة phi (مستوى الكوانتايل) قيمة scalar ثابتة. تُرفَض التعبيرات التي تتغيّر في كل خطوة، مثل histogram_quantile(time() / 1000, ...)، مع ظهور استثناء NOT_IMPLEMENTED. ملاحظة: تُرجع min_of(a, b) وmax_of(a, b) القيمة الأصغر أو الأكبر، على التوالي، من بين قيمتين من النوع scalar. يجب أن تكون كلتا الوسيطتين من النوع scalar. ملاحظة: الدوال min_of وmax_of وts_of_min_over_time وts_of_max_over_time وts_of_last_over_time وfirst_over_time وts_of_first_over_time وmad_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().

مثال

SELECT * FROM prometheusQueryRange(mytable, 'rate(http_requests{job="prometheus"}[10m])[1h:10m]', now() - INTERVAL 10 MINUTES, now(), INTERVAL 1 MINUTE)

مرجع SQL

أنواع البيانات

المحركات

الدوال

الصيغ

الإعدادات

جداول النظام

بحيرات البيانات

البنية

المعاملات

قيمة معادة

الميزات المدعومة في PromQL

المحددات

الدوال

العوامل

عوامل التجميع

مثال

​البنية

​المعاملات

​قيمة معادة

​الميزات المدعومة في PromQL

​المحددات

​الدوال

​العوامل

​عوامل التجميع

​مثال

البنية

المعاملات

قيمة معادة

الميزات المدعومة في PromQL

المحددات

الدوال

العوامل

عوامل التجميع

مثال