Share via

الاستعلام عن البيانات من Azure Time Series Insights Gen2

  • مقالة

ملاحظة

لن يتم دعم خدمة Time Series Insights (TSI) بعد مارس 2025. ضع في اعتبارك ترحيل بيئات TSI الحالية إلى حلول بديلة في أقرب وقت ممكن. لمزيد من المعلومات حول الإهمال والترحيل، تفضل بزيارة وثائقنا.

يتيح Azure Time Series Insights Gen2 الاستعلام عن البيانات على الأحداث وبيانات التعريف المخزنة في البيئة عبر واجهات برمجة تطبيقات السطح العام. تستخدم واجهات برمجة التطبيقات هذه أيضا من قبل Azure Time Series Insights TSI Explorer.

تتوفر ثلاث فئات أساسية لواجهة برمجة التطبيقات في Azure Time Series Insights Gen2:

  • واجهات برمجة تطبيقات البيئة: تمكن واجهات برمجة التطبيقات هذه الاستعلامات على بيئة Azure Time Series Insights Gen2 نفسها. يمكن استخدام هذه لجمع قائمة البيئات التي يمكن للمتصل الوصول إليها وبيانات تعريف البيئة.
  • واجهات برمجة تطبيقات Model-Query (TSM-Q): تمكن عمليات الإنشاء والقراءة والتحديث والحذف (CRUD) على بيانات التعريف المخزنة في نموذج السلسلة الزمنية للبيئة. يمكن استخدام هذه للوصول إلى المثيلات والأنواع والتسلسلات الهرمية وتحريرها.
  • واجهات برمجة تطبيقات استعلام السلسلة الزمنية (TSQ): تمكن استرداد بيانات تتبع الاستخدام أو الأحداث كما يتم تسجيلها من موفر المصدر وتمكن الحسابات والتجميعات عالية الأداء على البيانات باستخدام دالات عددية وتجميعية متقدمة.

يستخدم Azure Time Series Insights Gen2 لغة تعبير غنية تستند إلى سلسلة، تعبير السلسلة الزمنية (TSX) للتعبير عن العمليات الحسابية في متغيرات السلسلة الزمنية.

نظرة عامة على واجهات برمجة تطبيقات Azure Time Series Insights Gen2

يتم دعم واجهات برمجة التطبيقات الأساسية التالية.

نظرة عامة على استعلام السلسلة الزمنية

واجهات برمجة تطبيقات البيئة

  • Get Environments API: إرجاع قائمة البيئات التي تم تخويل المتصل بالوصول إليها.
  • الحصول على واجهة برمجة تطبيقات توفر البيئات: إرجاع توزيع عدد الأحداث عبر الطابع $tsالزمني للحدث . تساعد واجهة برمجة التطبيقات هذه في تحديد ما إذا كانت هناك أي أحداث في البيئة عن طريق إرجاع عدد الأحداث المقسمة إلى فواصل زمنية، إن وجدت.
  • الحصول على واجهة برمجة تطبيقات مخطط الحدث: إرجاع بيانات تعريف مخطط الحدث لنطاق بحث معين. تساعد واجهة برمجة التطبيقات هذه في استرداد جميع بيانات التعريف والخصائص المتوفرة في المخطط لنطاق البحث المحدد.

واجهات برمجة تطبيقات Model-Query السلاسل الزمنية (TSM-Q)

تدعم معظم واجهات برمجة التطبيقات هذه عملية تنفيذ الدفعات لتمكين عمليات CRUD الدفعية على كيانات نموذج السلسلة الزمنية المتعددة:

واجهات برمجة تطبيقات استعلام السلسلة الزمنية (TSQ)

تتوفر واجهات برمجة التطبيقات هذه عبر كلا المخزنين (دافئ وبارد) في حل التخزين متعدد الطبقات.

  • Get Events API: تمكين الاستعلام واسترداد الأحداث الأولية والطوابع الزمنية للحدث المقترنة كما يتم تسجيلها في Azure Time Series Insights Gen2 من موفر المصدر. تسمح واجهة برمجة التطبيقات هذه باسترداد الأحداث الأولية لمعرف سلسلة زمنية معين وامتداد بحث. تدعم واجهة برمجة التطبيقات هذه ترقيم الصفحات لاسترداد مجموعة بيانات الاستجابة الكاملة للإدخال المحدد.

    هام

    كجزء من التغييرات القادمة على قواعد تسوية JSON والهروب منها، سيتم تخزين الصفائف كنوع ديناميكي . لا يمكن الوصول إلى خصائص الحمولة المخزنة بهذا النوع إلا من خلال واجهة برمجة تطبيقات Get Events.

  • Get Series API: تمكين الاستعلام واسترداد القيم المحسوبة والطوابع الزمنية للحدث المقترنة عن طريق تطبيق العمليات الحسابية المحددة بواسطة المتغيرات على الأحداث الأولية. يمكن تعريف هذه المتغيرات إما في نموذج السلسلة الزمنية أو توفيرها مضمنة في الاستعلام. تدعم واجهة برمجة التطبيقات هذه ترقيم الصفحات لاسترداد مجموعة بيانات الاستجابة الكاملة للإدخال المحدد.

  • واجهة برمجة تطبيقات السلسلة التجميعية: تمكن الاستعلام واسترداد القيم المجمعة والطوابع الزمنية للفاصل الزمني المقترنة من خلال تطبيق العمليات الحسابية المحددة بواسطة المتغيرات على الأحداث الأولية. يمكن تعريف هذه المتغيرات إما في نموذج السلسلة الزمنية أو توفيرها مضمنة في الاستعلام. تدعم واجهة برمجة التطبيقات هذه ترقيم الصفحات لاسترداد مجموعة بيانات الاستجابة الكاملة للإدخال المحدد.

    بالنسبة إلى فترة بحث وفاصل زمني محدد، تقوم واجهة برمجة التطبيقات هذه بإرجاع استجابة مجمعة لكل فاصل زمني لكل متغير لمعرف السلسلة الزمنية. يتم حساب عدد الفواصل الزمنية في مجموعة بيانات الاستجابة عن طريق حساب علامات تجزئة الحقبة (عدد المللي ثانية التي انقضت منذ حقبة Unix - 1 يناير 1970) وتقسيم علامات التجزئة على حجم فترة الفاصل الزمني المحدد في الاستعلام.

    الطوابع الزمنية التي تم إرجاعها في مجموعة الاستجابة هي من حدود الفاصل الزمني الأيسر، وليس من الأحداث التي تم أخذ عينات منها من الفاصل الزمني.

تحديد نوع المتجر

يمكن تنفيذ واجهات برمجة التطبيقات أعلاه فقط مقابل أحد نوعي التخزين (بارد أو دافئ) في مكالمة واحدة. يتم استخدام معلمات عنوان URL للاستعلام لتحديد نوع المخزن الذي يجب تنفيذ الاستعلام عليه.

إذا لم يتم تحديد معلمة، فسيتم تنفيذ الاستعلام على Cold Store، بشكل افتراضي. إذا كان الاستعلام يمتد عبر نطاق زمني متداخل مع كل من المخزن البارد والمخزن الدافئ، فمن المستحسن توجيه الاستعلام إلى المخزن البارد للحصول على أفضل تجربة لأن المخزن الدافئ سيحتوي فقط على بيانات جزئية.

يقوم مستكشف Azure Time Series Insightsوموصل Power BI بإجراء مكالمات إلى واجهات برمجة التطبيقات أعلاه وسيحدد تلقائيا معلمة storeType الصحيحة حيثما كان ذلك مناسبا.

الخطوات التالية