Dotazovací jazyk Azure Digital Twins
Tento článek popisuje základy dotazovacího jazyka a jeho schopností. Vzpomeňte si, že centrem služby Azure Digital Twins je graf dvojčat vytvořený z digitálních dvojčat a vztahů. Tento graf se dá dotazovat, aby získal informace o digitálních dvojčatech a relacích, které obsahuje. Tyto dotazy se píšou ve vlastním dotazovacím jazyce podobném SQL, který se označuje jako dotazovací jazyk Azure Digital Twins. Tento jazyk je podobný dotazovacímu jazyku IoT Hubu s mnoha srovnatelnými funkcemi.
Podrobnější příklady syntaxe dotazů a způsob spouštění požadavků na dotazy najdete v tématu Dotazování na graf dvojčete.
O dotazech
Dotazovací jazyk Azure Digital Twins můžete použít k načtení digitálních dvojčat podle jejich...
- Vlastnosti (včetně vlastností značek)
- Modely
- Relace
- Vlastnosti relací
K odeslání dotazu do služby z klientské aplikace použijete rozhraní API pro dotazy Azure Digital Twins. Jedním ze způsobů, jak použít rozhraní API, je použití jedné ze sad SDK pro Azure Digital Twins.
Referenční dokumentace
Referenční informace k dotazovacímu jazyku najdete v části Referenční informace v levém obsahu pro dokumentaci ke službě Azure Digital Twins. Můžete také přejít přímo do referenčních oddílů pomocí následujících odkazů:
Důležité informace o dotazování
Při psaní dotazů pro Azure Digital Twins mějte na paměti následující aspekty:
Zapamatujte si citlivost na malá a velká písmena: Všechny operace dotazů Azure Digital Twins se rozlišují malá a velká písmena, proto se starají o použití přesných názvů definovaných v modelech. Pokud jsou názvy vlastností nesprávně napsané nebo nesprávně napsané, sada výsledků je prázdná bez vrácených chyb.
Řídicí jednoduché uvozovky: Pokud text dotazu obsahuje v datech jeden znak uvozovky, bude nutné uvozovky uvozovky uvozovat znakem
\. Tady je příklad, který se zabývá hodnotou vlastnosti D'Souza:SELECT * FROM DIGITALTWINS WHERE Name = 'D\'Souza'
Poznámka:
Po provedení změny dat v grafu může docházet k latenci až 10 sekund, než se změny projeví v dotazech.
Rozhraní API DigitalTwins okamžitě odráží změny, takže pokud potřebujete okamžitou odpověď, použijte požadavek rozhraní API (DigitalTwins GetById) nebo volání sady SDK (GetDigitalTwin) k získání dat dvojčat místo dotazu.
Dotazování historizovaných dat dvojčete v průběhu času
Dotazovací jazyk Azure Digital Twins slouží pouze k dotazování aktuálního stavu digitálních dvojčat a relací.
Pokud chcete spouštět dotazy na data grafu historizovaného dvojčete shromážděná v průběhu času, použijte funkci historie dat k připojení instance Služby Azure Digital Twins ke clusteru Azure Data Exploreru . Tím se automaticky historizují aktualizace grafu v Azure Data Exploreru, kde se dají dotazovat pomocí modulu plug-in Azure Digital Twins pro Azure Data Explorer.
Další kroky
Naučte se psát dotazy a zobrazit příklady kódu klienta v grafu dvojčete.