مرجع لغة استعلام Azure Digital Twins: Functions

هل هذه الصفحة مفيدة؟

هل لديك ملاحظات إضافية؟

سيتم إرسال الملاحظات إلى Microsoft: بالضغط على الزر «إرسال»، سيتم استخدام ملاحظاتك لتحسين منتجات Microsoft وخدماتها. نهج الخصوصية.

يحتوي هذا المستند على معلومات مرجعية حول وظائفلغة استعلام Azure Digital Twins.

CONTAINS

دالة سلسلة لتحديد ما إذا كانت خاصية سلسلة لتوأم تحتوي على قيمة سلسلة محددة أخرى.

بناء الجملة

CONTAINS(<string-to-check>,<contained-string>)

الوسيطات

• <string-to-check>خاصية توأم من نوع السلسلة تريد التحقق من القيمة المحددة:
• <contained-string>سلسلة تمثل القيمة التي يجب التحقق منها:

المرتجعات

قيمة منطقية تشير إلى ما إذا كان تعبير السلسلة الأول يحتوي على تسلسل الأحرف المحددة في تعبير السلسلة الثاني.

مثال

يقوم الاستعلام التالي بإرجاع كافة التوائم الرقمية التي تحتوي معرفاتها على -route. السلسلة التي $dtId يجب التحقق منها هي كل توأم في المجموعة ، والسلسلة المضمنة هي -route.

SELECT *
FROM DIGITALTWINS T
WHERE CONTAINS(T.$dtId, '-route')

ENDSWITH

دالة سلسلة لتحديد ما إذا كانت خاصية سلسلة لتوأم تنتهي بسلسلة أخرى معينة.

بناء الجملة

ENDSWITH(<string-to-check>,<ending-string>)

الوسيطات

• <string-to-check>خاصية توأم من نوع السلسلة تريد التحقق من نهايتها:
• <ending-string>سلسلة تمثل النهاية للتحقق من وجودها:

المرتجعات

قيمة منطقية تشير إلى ما إذا كان تعبير السلسلة الأول ينتهي بالثاني.

مثال

يرجع الاستعلام التالي كافة التوائم الرقمية التي تنتهي معرفاتها ب -small. السلسلة التي $dtId يجب التحقق منها هي كل توأم في المجموعة ، والسلسلة النهائية هي -small.

SELECT *
FROM DIGITALTWINS T
WHERE ENDSWITH(T.$dtId, '-small')

IS_BOOL

دالة تدقيق النوع والصب لتحديد ما إذا كان التعبير يحتوي على قيمة منطقية أم لا.

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

بناء الجملة

IS_BOOL(<expression>)

الوسيطات

<expression>، وهو تعبير للتحقق مما إذا كان منطقيا.

المرتجعات

قيمة منطقية تشير إلى ما إذا كان نوع التعبير المحدد منطقيا.

مثال

يحدد الاستعلام التالي التوائم الرقمية التي لها خاصية HasTemperature منطقية.

SELECT *
FROM DIGITALTWINS T
WHERE IS_BOOL( HasTemperature )

يعتمد الاستعلام التالي على المثال أعلاه لتحديد التوائم الرقمية التي لها خاصية منطقية HasTemperature ، وقيمة هذه الخاصية ليست false.

SELECT *
FROM DIGITALTWINS T
WHERE IS_BOOL( HasTemperature ) AND HasTemperature != false

IS_DEFINED

وظيفة فحص النوع والصب للتحقق مما إذا كان يتم تعريف الخاصية أم لا.

يتم دعم هذا فقط عندما تكون قيمة الخاصية من النوع البدائي. تتضمن الأنواع البدائية سلسلة أو منطقية أو رقمية أو null. DateTimeوأنواع الكائنات والمصفوفات غير مدعومة.

بناء الجملة

IS_DEFINED(<property>)

الوسيطات

<property>، وهي خاصية لتحديد ما إذا كان قد تم تعريفها أم لا. يجب أن تكون الخاصية من النوع البدائي.

المرتجعات

قيمة منطقية تشير إلى ما إذا كان قد تم تعيين قيمة للخاصية.

مثال

يرجع الاستعلام التالي كافة التوائم الرقمية التي لها خاصية محددة Location .

SELECT *
FROM DIGITALTWINS
WHERE IS_DEFINED(Location)

IS_NULL

دالة تدقيق النوع والصب لتحديد ما إذا كانت قيمة التعبير هي null.

بناء الجملة

IS_NULL(<expression>)

الوسيطات

<expression>، وهو تعبير للتحقق مما إذا كان لاغيا أم لا.

المرتجعات

قيمة منطقية تشير إلى ما إذا كان نوع التعبير المحدد هو null.

مثال

يرجع الاستعلام التالي التوائم الذين ليس لديهم قيمة فارغة لدرجة الحرارة. لمزيد من المعلومات حول عامل التشغيل المستخدم في هذا الاستعلام NOT ، راجع مرجع لغة استعلام Azure Digital Twins: عوامل التشغيل.

SELECT *
FROM DIGITALTWINS T
WHERE NOT IS_NULL(T.Temperature)

IS_NUMBER

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

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

بناء الجملة

IS_NUMBER(<expression>)

الوسيطات

<expression>، وهو تعبير للتحقق مما إذا كان رقما.

المرتجعات

قيمة منطقية تشير إلى ما إذا كان نوع التعبير المحدد رقما.

مثال

يحدد الاستعلام التالي التوائم الرقمية التي لها خاصية Capacity رقمية وقيمتها لا تساوي 0.

SELECT * 
FROM DIGITALTWINS 
WHERE IS_NUMBER( Capacity ) AND Capacity != 0

IS_OBJECT

دالة تدقيق النوع والصب لتحديد ما إذا كانت قيمة التعبير من نوع كائن JSON.

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

بناء الجملة

IS_OBJECT<expression>)

الوسيطات

<expression>، وهو تعبير للتحقق مما إذا كان من نوع كائن.

المرتجعات

قيمة منطقية تشير إلى ما إذا كان نوع التعبير المحدد هو كائن JSON.

مثال

يحدد الاستعلام التالي جميع التوائم الرقمية حيث يكون هذا كائنا يسمى MapObject، وليس له خاصية TemperatureReadingتابعة .

SELECT * 
FROM DIGITALTWINS 
WHERE IS_OBJECT( MapObject ) AND NOT IS_DEFINED ( MapObject.TemperatureReading )

IS_OF_MODEL

وظيفة فحص النوع والصب لتحديد ما إذا كان التوأم من نوع طراز معين. يتضمن النماذج التي ترث من النموذج المحدد.

بناء الجملة

IS_OF_MODEL(<twin-collection>,'<model-ID>', exact)

الوسيطات

مطلوب:

• <model-ID>معرف النموذج المطلوب التحقق منه.:

اختياري:

• <twin-collection>حدد مجموعة مزدوجة للبحث عندما يكون هناك أكثر من مجموعة واحدة (مثل عند استخدام مجموعة JOIN ).:
• exactتتطلب مطابقة تامة.: إذا لم يتم تعيين هذه المعلمة، فستتضمن مجموعة النتائج توائم ذات نماذج ترث من النموذج المحدد.

المرتجعات

قيمة منطقية تشير إلى ما إذا كان التوأم المحدد يطابق نوع الطراز المحدد.

مثال

يقوم الاستعلام التالي بإرجاع التوائم من مجموعة DT التي هي بالضبط من نوع dtmi:example:room;1النموذج .

SELECT ROOM FROM DIGITALTWINS DT WHERE IS_OF_MODEL(DT, 'dtmi:example:room;1', exact)

IS_PRIMITIVE

دالة تدقيق النوع والصب لتحديد ما إذا كانت قيمة التعبير من نوع بدائي (سلسلة أو منطقية أو رقمية أو null).

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

بناء الجملة

IS_PRIMITIVE(<expression>)

الوسيطات

<expression>، وهو تعبير للتحقق مما إذا كان من النوع البدائي.

المرتجعات

قيمة منطقية تشير إلى ما إذا كان نوع التعبير المحدد أحد الأنواع البدائية (سلسلة أو منطقية أو رقمية أو null).

مثال

يرجع الاستعلام area التالي خاصية المصنع مع معرف "ABC"، فقط إذا كانت area الخاصية من النوع البدائي. لمزيد من المعلومات حول إسقاط أعمدة معينة في نتيجة الاستعلام (كما يفعل هذا الاستعلام مع area)، راجع مرجع لغة استعلام Azure Digital Twins: عبارة SELECT.

SELECT Factory.area
FROM DIGITALTWINS Factory
WHERE Factory.$dtId = 'ABC'
AND IS_PRIMITIVE(Factory.area)

IS_STRING

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

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

بناء الجملة

IS_STRING(<expression>)

الوسيطات

<expression>، وهو تعبير للتحقق مما إذا كانت سلسلة.

المرتجعات

قيمة منطقية تشير إلى ما إذا كان نوع التعبير المحدد عبارة عن سلسلة.

مثال

يحدد الاستعلام التالي التوائم الرقمية التي لها خاصية Status خاصية سلسلة وقيمتها لا تساوي Completed.

SELECT * 
FROM DIGITIALTWINS 
WHERE IS_STRING( Status ) AND Status != 'Completed'

STARTSWITH

دالة سلسلة لتحديد ما إذا كانت خاصية سلسلة لتوأم تبدأ بسلسلة أخرى معينة.

بناء الجملة

STARTSWITH(<string-to-check>,<beginning-string>)

الوسيطات

• <string-to-check>خاصية توأم من نوع السلسلة تريد التحقق من بداية
• <beginning-string>سلسلة تمثل البداية للتحقق من وجودها:

المرتجعات

قيمة منطقية تشير إلى ما إذا كان تعبير السلسلة الأول يبدأ بالثاني.

مثال

يقوم الاستعلام التالي بإرجاع كافة التوائم الرقمية التي تبدأ معرفاتها ب area1-. السلسلة التي $dtId يجب التحقق منها هي كل توأم في المجموعة ، وسلسلة البداية هي area1-.

SELECT *
FROM DIGITALTWINS T
WHERE STARTSWITH(T.$dtId, 'area1-')