الاستعلام عن البيانات من Azure Time Series Insights Gen2
إشعار
سيتم إيقاف خدمة Time Series Insights في 7 يوليو 2024. ضع في اعتبارك ترحيل البيئات الموجودة إلى حلول بديلة في أقرب وقت ممكن. لمزيد من المعلومات حول الإهمال والترحيل، تفضل بزيارة وثائقنا.
يتيح Azure Time Series Insights Gen2 الاستعلام عن البيانات على الأحداث وبيانات التعريف المخزنة في البيئة عبر واجهات برمجة تطبيقات السطح العام. تستخدم واجهات برمجة التطبيقات هذه أيضا من قبل Azure Time Series Insights TSI Explorer.
تتوفر ثلاث فئات أساسية لواجهة برمجة التطبيقات في Azure Time Series Insights Gen2:
- واجهات برمجة التطبيقات للبيئة: تمكن واجهات برمجة التطبيقات هذه الاستعلامات على بيئة Azure Time Series Insights Gen2 نفسها. يمكن استخدام هذه لجمع قائمة البيئات التي يمكن للمتصل الوصول إليها وبيانات تعريف البيئة.
- واجهات برمجة التطبيقات Time Series Model-Query (TSM-Q): تمكن عمليات الإنشاء والقراءة والتحديث والحذف (CRUD) على بيانات التعريف المخزنة في نموذج السلسلة الزمنية للبيئة. يمكن استخدام هذه للوصول إلى المثيلات والأنواع والتسلسلات الهرمية وتحريرها.
- واجهات برمجة تطبيقات استعلام السلسلة الزمنية (TSQ): تمكين استرداد بيانات القياس عن بعد أو الأحداث كما يتم تسجيلها من موفر المصدر وتمكين الحسابات والتجميعات عالية الأداء على البيانات باستخدام دالات رقمية وتجميعية متقدمة.
يستخدم Azure Time Series Insights Gen2 لغة تعبير غنية تستند إلى سلسلة، تعبير السلسلة الزمنية (TSX)، للتعبير عن العمليات الحسابية في متغيرات السلسلة الزمنية.
نظرة عامة على واجهات برمجة التطبيقات Azure Time Series Insights Gen2
يتم دعم واجهات برمجة التطبيقات الأساسية التالية.
واجهات برمجة تطبيقات البيئة
- Get Environments API: إرجاع قائمة البيئات المخول للمتصل بالوصول إليها.
- Get Environments Availability API: إرجاع توزيع عدد الأحداث عبر الطابع
$tsالزمني للحدث . تساعد واجهة برمجة التطبيقات هذه في تحديد ما إذا كانت هناك أي أحداث في البيئة عن طريق إرجاع عدد الأحداث المقسمة إلى فواصل زمنية، إن وجدت. - الحصول على واجهة برمجة تطبيقات مخطط الحدث: إرجاع بيانات تعريف مخطط الحدث لنص بحث معين. تساعد واجهة برمجة التطبيقات هذه في استرداد جميع بيانات التعريف والخصائص المتوفرة في المخطط لنص البحث المحدد.
واجهات برمجة تطبيقات استعلام نموذج السلسلة الزمنية (TSM-Q)
تدعم معظم واجهات برمجة التطبيقات هذه عملية تنفيذ الدفعة لتمكين عمليات CRUD الدفعية على كيانات نموذج سلسلة زمنية متعددة:
- واجهة برمجة تطبيقات إعدادات النموذج: تمكن GET و PATCH من النوع الافتراضي واسم نموذج البيئة.
- واجهة برمجة تطبيقات الأنواع: تمكن CRUD على أنواع السلاسل الزمنية والمتغيرات المرتبطة بها.
- واجهة برمجة تطبيقات التسلسلات الهرمية: تمكن CRUD على التسلسلات الهرمية للسلسلة الزمنية ومسارات الحقول المقترنة بها.
- واجهة برمجة تطبيقات المثيلات: تمكن CRUD على مثيلات السلسلة الزمنية وحقول المثيل المقترنة بها. بالإضافة إلى ذلك، تدعم واجهة برمجة تطبيقات المثيلات العمليات التالية:
واجهات برمجة تطبيقات استعلام السلسلة الزمنية (TSQ)
تتوفر واجهات برمجة التطبيقات هذه عبر كلا المتجرين (دافئ وبارد) في حل التخزين متعدد الطبقات.
الحصول على واجهة برمجة تطبيقات الأحداث: تمكين الاستعلام واسترداد الأحداث الأولية والطوابع الزمنية للحدث المقترنة كما يتم تسجيلها في Azure Time Series Insights Gen2 من موفر المصدر. تسمح واجهة برمجة التطبيقات هذه باسترداد الأحداث الأولية لمعرف سلسلة زمنية معينة وامتداد بحث. تدعم واجهة برمجة التطبيقات هذه ترقيم الصفحات لاسترداد مجموعة بيانات الاستجابة الكاملة للإدخال المحدد.
هام
كجزء من التغييرات القادمة على قواعد التسطيح والهروب من JSON، سيتم تخزين الصفائف كنوع ديناميكي . لا يمكن الوصول إلى خصائص الحمولة المخزنة بهذا النوع إلا من خلال واجهة برمجة تطبيقات Get Events.
الحصول على واجهة برمجة تطبيقات السلسلة: تمكين الاستعلام واسترداد القيم المحسوبة والطوابع الزمنية للحدث المقترنة من خلال تطبيق العمليات الحسابية المحددة بواسطة المتغيرات على الأحداث الأولية. يمكن تعريف هذه المتغيرات إما في نموذج السلسلة الزمنية أو توفيرها مضمنة في الاستعلام. تدعم واجهة برمجة التطبيقات هذه ترقيم الصفحات لاسترداد مجموعة بيانات الاستجابة الكاملة للإدخال المحدد.
Aggregate Series API: يمكن الاستعلام واسترداد القيم المجمعة والطوابع الزمنية للفاصل الزمني المقترنة من خلال تطبيق العمليات الحسابية المحددة بواسطة المتغيرات على الأحداث الأولية. يمكن تعريف هذه المتغيرات إما في نموذج السلسلة الزمنية أو توفيرها مضمنة في الاستعلام. تدعم واجهة برمجة التطبيقات هذه ترقيم الصفحات لاسترداد مجموعة بيانات الاستجابة الكاملة للإدخال المحدد.
بالنسبة إلى فترة بحث وفاصل زمني محددين، تقوم واجهة برمجة التطبيقات هذه بإرجاع استجابة مجمعة لكل فاصل زمني لكل متغير لمعرف السلسلة الزمنية. يتم حساب عدد الفواصل الزمنية في مجموعة بيانات الاستجابة عن طريق حساب علامات التجزئة للفترات (عدد المللي ثانية التي انقضت منذ فترة Unix - 1 يناير 1970) وتقسيم علامات التجزئة على حجم الفاصل الزمني المحدد في الاستعلام.
الطوابع الزمنية التي تم إرجاعها في مجموعة الاستجابة هي من حدود الفاصل الزمني الأيسر، وليس من الأحداث التي تم أخذ عينات منها من الفاصل الزمني.
تحديد نوع المتجر
يمكن تنفيذ واجهات برمجة التطبيقات أعلاه فقط مقابل أحد نوعي التخزين (بارد أو دافئ) في مكالمة واحدة. يتم استخدام معلمات عنوان URL للاستعلام لتحديد نوع المخزن الذي يجب تنفيذ الاستعلام عليه.
إذا لم يتم تحديد معلمة، تنفيذ الاستعلام على Cold Store، بشكل افتراضي. إذا كان الاستعلام يمتد على نطاق زمني متداخل مع كل من المخزن البارد والمدفأ، فمن المستحسن توجيه الاستعلام إلى المخزن البارد للحصول على أفضل تجربة حيث سيحتوي المخزن الدافئ على بيانات جزئية فقط.
يقوم مستكشف Azure Time Series Insights وموصل Power BI بإجراء مكالمات إلى واجهات برمجة التطبيقات أعلاه وسيقوم تلقائيا بتحديد معلمة storeType الصحيحة حيثما كان ذلك مناسبا.
الخطوات التالية
- اقرأ المزيد حول المتغيرات المختلفة التي يمكن تعريفها في نموذج السلسلة الزمنية.
- اقرأ المزيد حول كيفية الاستعلام عن البيانات من مستكشف Azure Time Series Insights.