إضافة دعم لنوع البيانات الطويلة في Azure Time Series Insights Gen2

إشعار

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

تؤثر إضافة دعم لنوع البيانات الطويل على كيفية تخزين البيانات الرقمية وفهرستها في بيئات Azure Time Series Insights Gen2 فقط. إذا كانت لديك بيئة Gen1، يمكنك تجاهل هذه التغييرات.

بدءا من 29 يونيو أو 30 يونيو 2020، اعتمادا على منطقتك، سيتم فهرسة بياناتك على أنها طويلة ومضاعفة. إذا كانت لديك أي أسئلة أو مخاوف حول هذا التغيير، أرسل تذكرة دعم من خلال مدخل Microsoft Azure وأذكر هذا الاتصال.

إذا كنت متأثرا بأي من الحالات التالية، قم بإجراء التغييرات الموصى بها:

  • الحالة 1: تستخدم حاليا متغيرات نموذج السلسلة الزمنية وترسل أنواع البيانات المتكاملة فقط في بيانات القياس عن بعد.
  • الحالة 2: تستخدم حاليا متغيرات نموذج السلسلة الزمنية وترسل أنواع البيانات المتكاملة وغير الأساسية في بيانات القياس عن بعد.
  • الحالة 3: يمكنك استخدام متغيرات فئوية لتعيين قيم عدد صحيح إلى فئات.
  • الحالة 4: يمكنك استخدام JavaScript SDK لإنشاء تطبيق واجهة أمامية مخصصة.
  • الحالة 5: أنت تقترب من حد الاسم البالغ 1000 خاصية في 'المتجر الدافئ' وترسل بيانات متكاملة وغير مقصودة. يمكن عرض عدد الخصائص كمقياس في مدخل Microsoft Azure.

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

  • Azure Time Series Insights Explorer
  • أي عميل مخصص يستخدم واجهات برمجة التطبيقات الخاصة بنا

اعتمادا على حل IoT والقيود الخاصة بك، قد لا يكون لديك رؤية للبيانات المرسلة إلى بيئة Azure Time Series Insights Gen2. إذا لم تكن متأكدا إذا كانت بياناتك متكاملة فقط أو متكاملة وغير مقصودة، فلديك بعض الخيارات:

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

لتخزين الأحداث، قم بتشغيل التقاط الأحداث لمراكز أحداث Azure، أو توجيه من مركز IoT إلى تخزين Azure Blob.

يمكن أيضا ملاحظة البيانات من خلال مستكشف مركز الأحداث، أو باستخدام مضيف معالج الأحداث.

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

إشعار

قد تواجه تعطيلا إذا لم تقم بإجراء التغييرات الموصى بها. على سبيل المثال، سوف ترجع متغيرات Time Series Insights المتأثرة التي يتم الوصول إليها عبر واجهات برمجة التطبيقات للاستعلام أو مستكشف Time Series Insights قيمة خالية (أي عدم إظهار أي بيانات في المستكشف).

الحالة 1: استخدام متغيرات نموذج السلسلة الزمنية وإرسال أنواع البيانات المتكاملة فقط في بيانات تتبع الاستخدام

التغييرات الموصى بها للحالة 1 هي نفسها بالنسبة للحالة 2. اتبع الإرشادات الواردة في قسم الحالة 2.

الحالة 2: استخدام متغيرات نموذج السلسلة الزمنية وإرسال كل من الأنواع المتكاملة وغير الأساسية في بيانات تتبع الاستخدام

إذا قمت حاليا بإرسال بيانات تتبع استخدام عدد صحيح، تقسيم بياناتك إلى عمودين:

  • propertyValue_double
  • propertyValue_long

تكتب بيانات العدد الصحيح إلى propertyValue_long. لم يتم نسخ البيانات الرقمية التي تم تناولها مسبقا (والمقبلة) في propertyValue_double .

إذا كنت تريد الاستعلام عن البيانات عبر هذين العمودين لخاصية propertyValue ، تحتاج إلى استخدام الدالة العددية coalesce() في TSX. تقبل الدالة وسيطات نفس DataType وترجع القيمة الأولى غير الخالية في قائمة الوسيطات. لمزيد من المعلومات، راجع مفاهيم الوصول إلى بيانات Azure Time Series Insights Gen2.

تعريف المتغير في TSX - رقمي

تعريف المتغير السابق:

تظهر لقطة الشاشة مربع الحوار إضافة متغير جديد لمتغير PropertyValue، رقمي.

تعريف متغير جديد:

تظهر لقطة الشاشة مربع الحوار إضافة متغير جديد لمتغير PropertyValue بقيمة مخصصة رقمية.

يمكنك أيضا استخدام الاندماج($event.propertyValue.Double, toDouble($event.propertyValue.Long)) كتعبير سلسلة زمنية مخصص.

تعريف متغير مضمن باستخدام واجهات برمجة تطبيقات استعلام TSX - رقمية

تعريف المتغير السابق:

"PropertyValueVariable": {

    "kind": "numeric",

    "value": {

        "tsx": "$event.propertyValue.Double"

    },

    "filter": null,

    "aggregation": {

        "tsx": "avg($value)"
    }
}

تعريف متغير جديد:

"PropertyValueVariable ": {

    "kind": "numeric",

    "value": {

        "tsx": "coalesce($event.propertyValue.Long, toLong($event.propertyValue.Double))"

    },

    "filter": null,

    "aggregation": {

        "tsx": "avg($value)"
    }
}

يمكنك أيضا استخدام الاندماج($event.propertyValue.Double, toDouble($event.propertyValue.Long)) كتعبير سلسلة زمنية مخصص.

إشعار

نوصي بتحديث هذه المتغيرات في جميع الأماكن التي قد يتم استخدامها. تتضمن هذه الأماكن نموذج السلسلة الزمنية والاستعلامات المحفوظة واستعلامات موصل Power BI.

الحالة 3: استخدام المتغيرات الفئوية لتعيين قيم عدد صحيح إلى فئات

إذا كنت تستخدم حاليا متغيرات فئوية تعين قيم عدد صحيح إلى فئات، فمن المحتمل أنك تستخدم الدالة toLong لتحويل البيانات من نوع مزدوج إلى نوع طويل . تماما مثل الحالتين 1 و2، تحتاج إلى دمج العمودين Double و Long DataType .

تعريف المتغير في مستكشف السلسلة الزمنية - فئوي

تعريف المتغير السابق:

تظهر لقطة الشاشة مربع الحوار إضافة متغير جديد لمتغير PropertyValue، فئوي.

تعريف متغير جديد:

تظهر لقطة الشاشة مربع الحوار إضافة متغير جديد لمتغير PropertyValue بقيمة مخصصة، فئوية.

يمكنك أيضا استخدام الاندماج($event.propertyValue.Double, toDouble($event.propertyValue.Long)) كتعبير سلسلة زمنية مخصص.

لا تزال المتغيرات الفئوية تتطلب القيمة لتكون من نوع عدد صحيح. يجب أن يكون DataType لكافة الوسيطات في الاندماج() من النوع Long في تعبير السلسلة الزمنية المخصص.

تعريف متغير مضمن باستخدام واجهات برمجة تطبيقات استعلام TSX - فئوية

تعريف المتغير السابق:

"PropertyValueVariable_Long": {

    "kind": "categorical",

    "value": {

        "tsx": "tolong($event.propertyValue.Double)"

    },

    "categories": [

    {
        "label": "Good",

        "values": [0, 1, 2 ]

    },

    {

        "label": "Bad",

        "values": [ 3, 4 ]

    } ],

    "defaultCategory": {

        "label": "Unknown"

    }
}

تعريف متغير جديد:

"PropertyValueVariable_Long": {

    "kind": "categorical",

    "value": {

        "tsx": "coalesce($event.propertyValue.Long, tolong($event.propertyValue.Double))"

    },

    "categories": [

    {
        "label": "Good",

        "values": [0, 1, 2 ]

    },

    {

        "label": "Bad",

        "values": [ 3, 4 ]

    } ],

    "defaultCategory": {

        "label": "Unknown"

    }
}

لا تزال المتغيرات الفئوية تتطلب القيمة لتكون من نوع عدد صحيح. يجب أن يكون DataType لكافة الوسيطات في الاندماج() من النوع Long في تعبير السلسلة الزمنية المخصص.

إشعار

نوصي بتحديث هذه المتغيرات في جميع الأماكن التي قد يتم استخدامها. تتضمن هذه الأماكن نموذج السلسلة الزمنية والاستعلامات المحفوظة واستعلامات موصل Power BI.

الحالة 4: استخدام JavaScript SDK لإنشاء تطبيق واجهة أمامية مخصصة

إذا كنت متأثرا بالحالات من 1 إلى 3 وقمت بإنشاء تطبيقات مخصصة، فستحتاج إلى تحديث استعلاماتك لاستخدام الدالة coalesce() ، كما هو موضح في الأمثلة السابقة.

الحالة 5: الاقتراب من حد 1000 خاصية للمتجر الدافئ

إذا كنت أحد مستخدمي 'المتجر الدافئ' مع عدد كبير من الخصائص وتعتقد أن هذا التغيير من شأنه أن يدفع بيئتك إلى أكثر من 1000 اسم خاصية في 'المتجر الدافئ'، أرسل تذكرة دعم من خلال مدخل Microsoft Azure وأذكر هذا الاتصال.

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

  • عرض القائمة الكاملة من أنواع البيانات المدعومة.