Az Azure Digital Twins lekérdezési nyelve

Ez a cikk a lekérdezési nyelv alapjait és képességeit ismerteti. Ne feledje, hogy az Azure Digital Twins központja a digitális ikerpéldányokból és kapcsolatokból létrehozott ikergráf. Ez a gráf lekérdezhető, hogy információt kapjon a benne található digitális ikerpéldányokról és kapcsolatokról. Ezek a lekérdezések egy egyed, SQL-szerű lekérdezési nyelven vannak megírva, amelyet Azure Digital Twins lekérdezési nyelvnek neveznek. Ez a nyelv hasonló az IoT Hub lekérdezési nyelvéhez , számos hasonló funkcióval.

A lekérdezési szintaxisra és a lekérdezési kérelmek futtatására vonatkozó részletesebb példákért tekintse meg az ikergráf lekérdezése című témakört.

Tudnivalók a lekérdezésekről

Az Azure Digital Twins lekérdezési nyelvével lekérheti a digitális ikerpéldányokat a...

• Tulajdonságok (a címketulajdonságokat is beleértve)
• Modellek
• Kapcsolatok
  • A kapcsolatok tulajdonságai

Ha egy ügyfélalkalmazásból szeretne lekérdezést küldeni a szolgáltatásnak, az Azure Digital Twins Query API-t fogja használni. Az API használatának egyik módja az Azure Digital Twins egyik SDK-ja.

Referenciadokumentáció

A lekérdezés nyelvi referenciája az Azure Digital Twins dokumentációjának bal oldali tartalomjegyzékében található Hivatkozás területen található. Az alábbi hivatkozások használatával közvetlenül is megnyithatja a referenciaszakaszokat:

• Záradékok
  • SELECT
  • TÓL
  • GYUFA
  • CSATLAKOZIK
  • HOL
• Functions
• Operátorok
• Fenntartott kulcsszavak

A lekérdezés szempontjai

Az Azure Digital Twins lekérdezéseinek írásakor tartsa szem előtt az alábbi szempontokat:

• Ne feledje a kis- és nagybetűk érzékenységét: Minden Azure Digital Twins-lekérdezési művelet megkülönbözteti a kis- és nagybetűket, ezért ügyeljen arra, hogy a modellekben meghatározott pontos neveket használja. Ha a tulajdonságnevek hibásan vagy helytelenül vannak megadva, az eredményhalmaz üres, és nem ad vissza hibát.

• Önálló idézőjelek feloldása: Ha a lekérdezés szövege egyetlen idézőjelet tartalmaz az adatokban, az idézőjelet a \ karakterrel kell feloldani. Íme egy példa, amely a D'Souza tulajdonságértékével foglalkozik:

  SELECT * FROM DIGITALTWINS WHERE Name = 'D\'Souza'
  

Feljegyzés

A gráf adatainak módosítása után akár 10 másodperces késés is előfordulhat, mielőtt a módosítások megjelennek a lekérdezésekben.

A DigitalTwins API azonnal tükrözi a változásokat, ezért ha azonnali válaszra van szüksége, lekérdezés helyett használjon EGY API-kérést (DigitalTwins GetById) vagy egy SDK-hívást (GetDigitalTwin).

A historizált ikeradatok lekérdezése az idő függvényében

Az Azure Digital Twins lekérdezési nyelve csak a digitális ikerpéldányok és kapcsolatok jelenlegi állapotának lekérdezésére használható.

Az adatok előzményei funkcióval azure Digital Twins-példányát egy Azure Data Explorer-fürthöz csatlakoztathatja az idő múlásával összegyűjtött, historizált ikerdiagram-adatok lekérdezéseinek futtatásához. Ez automatikusan tárolja a gráffrissítéseket az Azure Data Explorerben, ahol lekérdezhetők az Azure Data ExplorerHez készült Azure Digital Twins beépülő modullal.

Következő lépések

Megtudhatja, hogyan írhat lekérdezéseket, és hogyan tekinthet meg ügyfélkód-példákat az ikergráf lekérdezésében.