أنواع البيانات المدعومة
ملاحظة
لن يتم دعم خدمة Insights السلاسل الزمنية (TSI) بعد مارس 2025. فكر في ترحيل بيئات TSI الحالية إلى حلول بديلة في أقرب وقت ممكن. لمزيد من المعلومات حول الإهمال والترحيل، يرجى زيارة وثائقنا.
يسرد الجدول التالي أنواع البيانات التي يدعمها Azure Time Series Insights Gen2
| نوع البيانات | الوصف | مثال | بناء جملة تعبير السلاسل الزمنية | اسم عمود الخاصية في باركيه |
|---|---|---|---|---|
| Bool | نوع بيانات يحتوي على إحدى الحالتين: true أو false. |
"isQuestionable" : true |
$event.isQuestionable.Bool أو $event['isQuestionable'].Bool |
isQuestionable_bool |
| التاريخ الزمني | يمثل لحظة في الوقت، يتم التعبير عنها عادةً كتاريخ ووقت من اليوم. يتم التعبير عنها بتنسيق ISO 8601 . يتم دائما تخزين خصائص Datetime بتنسيق UTC. سيتم تطبيق إزاحات المنطقة الزمنية ، إذا تم تنسيقها بشكل صحيح ، ثم سيتم تخزين القيمة في UTC. راجع هذا القسم للحصول على مزيد من المعلومات حول خاصية الطابع الزمني للبيئة وإزاحات التاريخ والوقت | "eventProcessedLocalTime": "2020-03-20T09:03:32.8301668Z" |
إذا كان "eventProcessedLocalTime" هو الطابع الزمني لمصدر الحدث: $event.$ts. إذا كانت خاصية JSON أخرى: $event.eventProcessedLocalTime.DateTime أو $event['eventProcessedLocalTime'].DateTime |
eventProcessedLocalTime_datetime |
| مزدوج | رقم 64 بت مزدوج الدقة | "value": 31.0482941 |
$event.value.Double أو $event['value'].Double |
value_double |
| طويل | عدد صحيح 64 بت موقع | "value" : 31 |
$event.value.Long أو $event['value'].Long |
value_long |
| string | القيم النصية، يجب أن تتكون من UTF-8 صالحة. يتم التعامل مع السلاسل الخالية والفارغة بنفس الطريقة. | "site": "DIM_MLGGG" |
$event.site.String أو $event['site'].String |
site_string |
| دينامي | نوع معقد (غير بدائي) يتكون إما من صفيف أو حقيبة خصائص (قاموس). في الوقت الحالي ، سيتم تخزين صفائف JSON المتوترة فقط من البدائيات أو صفائف الكائنات التي لا تحتوي على خاصية (خصائص) معرف TS أو الطابع الزمني كديناميكية. اقرأ هذه المقالة لفهم كيفية تسطيح الكائنات وإلغاء تشغيل المصفوفات. لا يمكن الوصول إلى خصائص الحمولة الصافية المخزنة كهذا النوع إلا عن طريق التحديد Explore Events في السلاسل الزمنية Insights Explorer لعرض الأحداث الأولية، أو من خلال واجهة برمجة تطبيقات الاستعلام GetEvents للتحليل من جانب العميل. |
"values": "[197, 194, 189, 188]" |
الإشارة إلى الأنواع الديناميكية في تعبير سلسلة زمنية غير معتمد بعد | values_dynamic |
ملاحظة
يتم دعم قيم عدد صحيح 64 بت، ولكن أكبر عدد يمكن ل Azure Time Series Insights Explorer التعبير عنه بأمان هو 9,007,199,254,740,991 (2^53-1) بسبب قيود جافا سكريبت. إذا كنت تعمل مع الأرقام في نموذج البيانات الخاص بك فوق هذا، يمكنك تقليل الحجم عن طريق إنشاء متغير نموذج سلسلة زمنيةوتحويل القيمة.
ملاحظة
نوع السلسلة غير قابل للإلغاء:
- سيتصرف تعبير السلسلة الزمنية (TSX) المعبر عنه في استعلام سلسلة زمنية يقارن قيمة سلسلة فارغة ('') مقابل NULL بنفس الطريقة:
$event.siteid.String = NULLيعادل .$event.siteid.String = '' - قد تقوم واجهة برمجة التطبيقات بإرجاع قيم NULL حتى إذا كانت الأحداث الأصلية تحتوي على سلاسل فارغة.
- لا تعتمد على قيم NULL في أعمدة السلسلة لإجراء مقارنات أو تقييمات، تعامل معها بنفس الطريقة التي تعامل بها السلاسل الفارغة.
إرسال أنواع بيانات مختلطة
تتم كتابة بيئة Azure Time Series Insights Gen2 بقوة. إذا أرسلت الأجهزة أو العلامات بيانات من أنواع مختلفة لخاصية جهاز، تخزين القيم في عمودين منفصلين ويجب استخدام الدالة coalesce() عند تعريف تعبيرات متغير طراز السلسلة الزمنية في استدعاءات واجهة برمجة التطبيقات.
يوفر Azure Time Series Insights Explorer طريقة لتجميع الأعمدة المنفصلة لخاصية الجهاز نفسها تلقائيا. في المثال أدناه، يرسل المستشعر خاصية PresentValue يمكن أن تكون طويلة أو مزدوجة. للاستعلام عن جميع القيم المخزنة (بغض النظر عن نوع البيانات) للموقع PresentValue ، اختر PresentValue (Double | Long) وسيتم دمج الأعمدة نيابة عنك.
الكائنات والمصفوفات
يمكنك إرسال أنواع معقدة مثل الكائنات والمصفوفات كجزء من حمولة الحدث. سيتم تسطيح الكائنات المتداخلة وسيتم تخزين المصفوفات إما كأحداث dynamic متعددة أو تسويتها لإنتاج أحداث متعددة اعتمادا على تكوين البيئة وشكل JSON. لمعرفة المزيد ، اقرأ حول قواعد JSON للتسطيح والهروب
الخطوات التالية
اقرأ قواعد JSON للتسطيح والهروب لفهم كيفية تخزين الأحداث.
فهم قيود الإنتاجية في بيئتك
تعرف على مصادر الأحداث لاستيعاب بيانات البث.