لغة استعلام Azure Digital Twins
توضح هذه المقالة أساسيات لغة الاستعلام وقدراته. تذكر أن مركز Azure Digital Twins هو الرسم البياني المزدوج، الذي تم إنشاؤه من التوائم الرقمية والعلاقات. يمكن الاستعلام عن هذا الرسم البياني للحصول على معلومات عن التوائم الرقمية والعلاقات التي يحتوي عليها. تتم كتابة هذه الاستعلامات بلغة استعلام مخصصة تشبه SQL، ويشار إليها باسم لغة استعلام Azure Digital Twins. تشبه هذه اللغة لغة استعلام IoT Hub مع العديد من الميزات المشابهة.
للحصول على أمثلة أكثر تفصيلا لبناء جملة الاستعلام وكيفية تشغيل طلبات الاستعلام، راجع الاستعلام عن الرسم البياني المزدوج.
حول الاستعلامات
يمكنك استخدام لغة استعلام Azure Digital Twins لاسترداد التوائم الرقمية وفقا ل...
- الخصائص (بما في ذلك خصائص العلامة)
- النماذج
- العلاقات
- خصائص العلاقات
لإرسال استعلام إلى الخدمة من تطبيق عميل، ستستخدم Azure Digital Twins Query API. إحدى الطرق لاستخدام واجهة برمجة التطبيقات هي من خلال إحدى SDKs ل Azure Digital Twins.
الوثائق المرجعية
يمكن العثور على مرجع لغة الاستعلام ضمن مرجع في جدول المحتويات الأيسر لوثائق Azure Digital Twins. يمكنك أيضا الانتقال مباشرة إلى الأقسام المرجعية باستخدام الارتباطات أدناه:
اعتبارات الاستعلام
عند كتابة استعلامات عن Azure Digital Twins، ضع الاعتبارات التالية في الاعتبار:
تذكر حساسية حالة الأحرف: جميع عمليات استعلام Azure Digital Twins حساسة لحالة الأحرف، لذا احرص على استخدام الأسماء الدقيقة المحددة في النماذج. إذا كانت أسماء الخصائص بها أخطاء إملائية أو تم تغليفها بشكل غير صحيح، فستكون مجموعة النتائج فارغة ولا يتم إرجاع أي أخطاء.
الهروب من علامات الاقتباس المفردة: إذا كان نص الاستعلام الخاص بك يتضمن حرف اقتباس مفرد في البيانات، فيجب إبطال الاقتباس بالحرف
\. فيما يلي مثال يتناول قيمة خاصية D'Souza:SELECT * FROM DIGITALTWINS WHERE Name = 'D\'Souza'
إشعار
بعد إجراء تغيير على البيانات في الرسم البياني، قد يكون هناك زمن انتقال مدته 10 ثوان بحد أقصى قبل ظهور التغييرات في الاستعلامات.
يُظهر DigitalTwins API التغييرات على الفور، لذا، إذا كنت بحاجة إلى استجابة فورية، استخدم طلب API(DigitalTwins GetById) أو استدعاء SDK (GetDigitalTwin) للحصول على بيانات مزدوجة بدلاً من استعلام.
الاستعلام عن بيانات التوأم المستورة بمرور الوقت
لغة استعلام Azure Digital Twins هي فقط للاستعلام عن الحالة الحالية للتوائم الرقمية والعلاقات.
لتشغيل الاستعلامات على بيانات الرسم البياني المزدوجة المخزنة التي تم جمعها بمرور الوقت، استخدم ميزة محفوظات البيانات لتوصيل مثيل Azure Digital Twins بمجموعة Azure Data Explorer . سيؤدي ذلك إلى تخزين تحديثات الرسم البياني تلقائيا إلى Azure Data Explorer، حيث يمكن الاستعلام عن هذه التحديثات باستخدام المكون الإضافي Azure Digital Twins ل Azure Data Explorer.
الخطوات التالية
تعرف على كيفية كتابة الاستعلامات ورؤية أمثلة التعليمات البرمجية للعميل في الاستعلام عن الرسم البياني المزدوج.