استعلامات StableNet
ينطبق هذا القسم على الأنظمة المتكاملة مع StableNet® فقط
يمكن الاستعلام عن بيانات StableNet® من مجموعة بيانات مجمعة في قاعدة بيانات SKOOR المحلية وكذلك في الوقت الفعلي من واجهة برمجة تطبيقات StableNet® API. تساعد الإرشادات التالية على الجمع بين هاتين الطريقتين وتحسينهما.
إعداد استعلام بيانات مادي للأجهزة والقياسات
يوفر مثال الاستعلام التالي بيانات أساسية للاستخدام مع عنصر واجهة المستخدم FilterMatrix (مثل التصفية حسب الأجهزة أو القياسات) وكذلك لربط بيانات القياس من واجهة برمجة تطبيقات StableNet® API أو جدول البيانات المجمعة. يجب تعيين مصدر البيانات إلى نوع StableNet.
-- Data query example "device_measurement" SELECT std.id AS device_id, std.display_name AS device_name, sm.id as measurement_id, sm.name as measurement_name FROM stablenet_taggable_device std JOIN stablenet_measurement sm ON std.id = sm.dest_device_id
نظرًا لأن بيانات الأجهزة والقياسات لا تتغير كثيرًا، ينبغي جعل هذا الاستعلام ماديًا. سيزداد الأداء بشكل ملحوظ.
اضبط الفاصل الزمني للتحديث على daily وأنشئ فهارس لجميع السمات:
ربط جدول خارجي للحصول على بيانات في الوقت الفعلي
علاوة على استعلام البيانات المادي المُعد، يمكن ربط البيانات من واجهة برمجة تطبيقات StableNet® API باستخدام جدول خارجي.
تشير الكلمة المفتاحية FROM في المثال التالي إلى الاستعلام المادي المُعد أعلاه.
SELECT
dm.device_id,
dm.device_name,
dm.measurement_name,
dm.measurement_id,
sma.metric_key,
sma.metric_name,
sma.interval,
sma.min,
sma.max,
sma.avg,
sma.timestamp
FROM device_measurement dm
JOIN stablenet_measurement_data sma
ON dm.measurement_id = sma.measurement_id
WHERE sma.start = ${begin}::timestamptz
AND sma."end" = ${end}::timestamptz
AND sma.bucket_size = EXTRACT(
EPOCH FROM ('1 ' || ${bucket_size})::interval
)::integer
AND sma.metric_name = ${metric_name}
في لوحة المعلومات أو معاينة البيانات، يجب تعيين السمات التالية لمثال الاستعلام هذا:
begin/end: الطابع الزمني بتنسيق ISO 8601، مثل 2024-05-01T00:00:00Z
bucket_size: الفاصل الزمني بالكلمات مثل hour، وday، وmonth، إلخ.
metric_name: اسم مقياس StableNet® صالح مثل Round Trip Time
بدلاً من metric_name، جرّب استخدام السمة metric_key في جملة WHERE لتحديد مقياس معين في حال توفر أكثر من مقياس
ربط جدول البيانات المجمعة
إذا كان الأداء أكثر أهمية من البيانات في الوقت الفعلي، فينبغي تفضيل جدول البيانات المجمعة على الجداول الخارجية.
تشير الكلمة المفتاحية FROM في المثال التالي إلى الاستعلام المادي المُعد أعلاه.
SELECT
dm.device_id,
dm.device_name,
dm.measurement_name,
dm.measurement_id,
sma.metric_key,
sma.metric_name,
sma.interval,
sma.min,
sma.max,
sma.avg,
sma.timestamp
FROM device_measurement dm
JOIN stablenet_measurement_data_aggregated sma
ON dm.measurement_id = sma.measurement_id
WHERE sma.timestamp BETWEEN ${begin}::timestamptz AND ${end}::timestamptz
AND sma.metric_name = ${metric_name}
في لوحة المعلومات أو معاينة البيانات، يجب تعيين السمات التالية لمثال الاستعلام هذا:
begin/end: الطابع الزمني بتنسيق ISO 8601، مثل 2024-05-01T00:00:00Z
metric_name: اسم مقياس StableNet® صالح مثل Round Trip Time
بدلاً من metric_name، جرّب استخدام السمة metric_key في جملة WHERE لتحديد مقياس معين في حال توفر أكثر من مقياس
الجداول الخارجية
الاسم | الحقول | المؤهلات |
|---|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
على الرغم من أن measurement_id وmetric_key اختياريان، فإنه لا يُنصح بتنفيذ الاستعلامات بدونهما. يؤدي القيام بذلك إلى قراءة بيانات القياس لجميع القياسات وجميع المقاييس، مما قد يستغرق وقتًا طويلاً للقراءة ويضع حملاً ثقيلاً على خادم StableNet. يُنصح بذلك فقط للنطاقات الزمنية القصيرة جدًا < 1h. إذا كانت هناك حاجة إلى عدة قياسات ومقاييس، فينبغي استخدام الجدول stablenet_measurement_data_aggregated.
بيانات القياس المجمعة
مجمعة حسب الساعة، ويتم تحديثها تلقائيًا كل ساعة. يمكن استخدامها لتنفيذ استعلامات التحليلات عبر مجموعة واسعة من القياسات وعلى نطاقات زمنية كبيرة.
هي في الأساس جدول Timescale hypertable (https://docs.timescale.com/ ). حجم الجزء (Chunk) هو 7 أيام، ويتم ضغط الأجزاء بعد 7 أيام.
الاسم | الحقول |
|---|---|
|
|
يحتوي stablenet_measurement_data_aggregated فقط على بيانات لمفاتيح المقاييس المكونة.


