أفضل الممارسات لاختيار معرف السلسلة الزمنية
ملاحظة
لن يتم دعم خدمة Time Series Insights (TSI) بعد مارس 2025. ضع في اعتبارك ترحيل بيئات TSI الحالية إلى حلول بديلة في أقرب وقت ممكن. لمزيد من المعلومات حول الإهمال والترحيل، تفضل بزيارة وثائقنا.
تلخص هذه المقالة أهمية معرف السلسلة الزمنية لبيئة Azure Time Series Insights Gen2 وأفضل الممارسات لاختيار واحد.
اختيار معرف سلسلة زمنية
يعد تحديد معرف السلسلة الزمنية المناسب أمرا بالغ الأهمية. اختيار معرف السلسلة الزمنية يشبه اختيار مفتاح قسم لقاعدة بيانات. وهو مطلوب عند إنشاء بيئة Azure Time Series Insights Gen2.
شاهد البرنامج التعليمي لتوفير البيئة للحصول على شرح مفصل لمعرف السلسلة الزمنية. ستعرض مثالين مختلفين لحمولة بيانات تتبع الاستخدام JSON وتحديد معرف السلسلة الزمنية الصحيح لكل منهما.
هام
معرفات السلسلة الزمنية هي:
- خاصية سلسلة حساسة لحالة الأحرف : يتم استخدام أغلفة الأحرف والأحرف في عمليات البحث والمقارنات والتحديثات وعند التقسيم.
- خاصية غير قابلة للتغيير : بمجرد إنشائها لا يمكن تغييرها.
تلميح
إذا كان مصدر الحدث الخاص بك هو مركز IoT، فمن المحتمل أن يكون معرف السلسلة الزمنية iothub-connection-device-id. إذا كنت تخطط لاستخدام نماذج أجهزة IoT أجهزة التوصيل و التشغيل أو كنت تستخدمها بدون مكونات، يجب تضمين dt-subject كجزء من المفتاح المركب في حالة حاجتك إليه في المستقبل.
تتضمن أفضل الممارسات الرئيسية التي يجب اتباعها ما يلي:
- اختر مفتاح قسم مع العديد من القيم المميزة (على سبيل المثال، المئات أو الآلاف). في كثير من الحالات، قد يكون هذا هو معرف الجهاز أو معرف المستشعر أو معرف العلامة في JSON الخاص بك.
- يجب أن يكون معرف السلسلة الزمنية فريدا على مستوى العقدة الطرفية لنموذج السلسلة الزمنية.
- حد الأحرف لسلسلة اسم خاصية معرف السلسلة الزمنية هو 128. بالنسبة لقيمة خاصية معرف السلسلة الزمنية، يكون حد الأحرف هو 1024.
- إذا كانت قيمة خاصية فريدة لمعرف السلسلة الزمنية مفقودة، يتم التعامل معها كقيمة فارغة وتتبع نفس قاعدة قيد التفرد.
- إذا كان معرف السلسلة الزمنية متداخلا داخل كائن JSON معقد، فتأكد من اتباع قواعد تسوية الدخول عند توفير اسم الخاصية الخاصة بك. تحقق من المثال B.
- يمكنك أيضا تحديد ما يصل إلى ثلاث خصائص رئيسية كمعرف السلسلة الزمنية. ستكون تركيبتها مفتاحا مركبا يمثل معرف السلسلة الزمنية.
ملاحظة
يجب أن تكون خصائصك الرئيسية الثلاث سلاسل. سيتعين عليك الاستعلام مقابل هذا المفتاح المركب بدلا من خاصية واحدة في كل مرة.
تحديد أكثر من خاصية مفتاح واحدة
تصف السيناريوهات التالية تحديد أكثر من خاصية مفتاح واحدة كمعرف السلسلة الزمنية.
مثال 1: معرف السلسلة الزمنية بمفتاح فريد
- لديك أساطيل قديمة من الأصول. لكل منها مفتاح فريد.
- يتم تحديد أسطول واحد بشكل فريد بواسطة معرف الجهاز الخاص بالخاصية. بالنسبة لأسطول آخر، الخاصية الفريدة هي objectId. ولا يحتوي أي من الأسطولين على ممتلكات الأسطول الآخر الفريدة. في هذا المثال، يمكنك تحديد مفتاحين، deviceId و objectId، كمفاتيح فريدة.
- نحن نقبل القيم الخالية، ويحسب عدم وجود خاصية في حمولة الحدث كقيمة خالية. هذه هي أيضا الطريقة المناسبة للتعامل مع إرسال البيانات إلى مصدري أحداث حيث تحتوي البيانات في كل مصدر حدث على معرف سلسلة زمنية فريد.
مثال 2: معرف السلسلة الزمنية باستخدام مفتاح مركب
- تحتاج إلى خصائص متعددة لتكون فريدة داخل نفس أسطول الأصول.
- أنت شركة مصنعة للمباني الذكية وتنشر أجهزة الاستشعار في كل غرفة. في كل غرفة، عادة ما يكون لديك نفس القيم ل sensorId. ومن الأمثلة على ذلك sensor1 و sensor2 و sensor3.
- يحتوي المبنى الخاص بك على أرقام طوابق وغرف متداخلة عبر المواقع في الخاصية flrRm. تحتوي هذه الأرقام على قيم مثل 1aو2bو3a.
- لديك خاصية وموقع يحتوي على قيم مثل ريدموندوبرشلونةوطوكيو. لإنشاء التفرد، يمكنك تعيين الخصائص الثلاث التالية كمفاتيح معرف السلسلة الزمنية: sensorIdوflrRmوالموقع.
مثال على الحدث الأولي:
{
"sensorId": "sensor1",
"flrRm": "1a",
"location": "Redmond",
"temperature": 78
}
في مدخل Microsoft Azure، يمكنك بعد ذلك إدخال المفتاح المركب كما يلي:
ملاحظة
في مدخل Microsoft Azure، لا تدخل أسماء الخصائص المفصولة بفواصل في مربع نص واحد، وإلا، فسيتم التعامل معها كاسم خاصية واحد يحتوي على فواصل. أدخل كل اسم خاصية في مربع النص الخاص به.
الخطوات التالية
اقرأ قواعد تسوية JSON والهروب لفهم كيفية تخزين الأحداث.