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özéppontja 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ó a IoT Hub lekérdezési nyelvhez, 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 lásd : Az ikergráf lekérdezése.

A lekérdezések ismertetése

Az Azure Digital Twins lekérdezési nyelv használatával 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, használja az Azure Digital Twins Query API-t. Az API használatának egyik módja az Azure Digital Twins egyik SDK-ja.

Referenciadokumentáció

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

• Záradékok
  • SELECT
  • FELADÓ
  • MÉRKŐZÉS
  • CSATLAKOZZON
  • AHOL
• Functions
• Operátorok
• Fenntartott kulcsszavak

A lekérdezéssel kapcsolatos szempontok

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

• A kis- és nagybetűk megkülönböztetése: 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 elírva, az eredményhalmaz üres, és nem ad vissza hibát.

• Szimpla 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'
  

Megjegyzé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, így ha azonnali válaszra van szüksége, lekérdezés helyett használjon API-kérést (DigitalTwins GetById) vagy 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 idő múlásával összegyűjtött, historizált ikerpéldány-gráfadatok lekérdezéseinek futtatásához az adatelőzmények funkcióval csatlakoztassa az Azure Digital Twins-példányt egy Azure-Data Explorer-fürthöz. Ez automatikusan eltárolja az Azure Data Explorer gráffrissítéseit, ahol lekérdezhetők az Azure Data Explorer-hez készült Azure Digital Twins beépülő modullal.

Következő lépések

Megtudhatja, hogyan írhat lekérdezéseket, és tekinthet meg ügyfélkódpéldákat az ikergráf lekérdezése című témakörben.