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

  • مقالة
  • قراءة خلال 5 دقائق

ملاحظة

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

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

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

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

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

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

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

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

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

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

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

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

ملاحظة

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

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

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

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

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

  • propertyValue_double
  • propertyValue_long

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

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

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

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

Screenshot shows the Add a new variable dialog box for the PropertyValue Variable, numeric.

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

Screenshot shows the Add a new variable dialog box for the PropertyValue Variable with a custom value, numeric.

يمكنك أيضا استخدام coalesce($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)"
    }
}

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

ملاحظة

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

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

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

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

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

Screenshot shows the Add a new variable dialog box for the PropertyValue Variable, categorical.

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

Screenshot shows the Add a new variable dialog box for the PropertyValue Variable with a custom value, categorical.

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

لا تزال المتغيرات الفئوية تتطلب أن تكون القيمة من نوع عدد صحيح. يجب أن يكون DataType لكافة الوسيطات الموجودة في coalesce() من النوع 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 لكافة الوسيطات الموجودة في coalesce() من النوع Long في تعبير السلاسل الزمنية المخصص.

ملاحظة

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

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

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

الحالة 5: الاقتراب من حد الإقامة في Warm Store البالغ 1000 عقار

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

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