Dotazovací jazyk Služby Azure Digital Twins

Tento článek popisuje základy dotazovacího jazyka a jeho možnosti. 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 a získat 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ý IoT Hub dotazovacímu jazyku s mnoha srovnatelnými funkcemi.

Podrobnější příklady syntaxe dotazů a způsobu spouštění žádostí o dotazy najdete v tématu Dotazování grafu dvojčat.

O dotazech

Pomocí dotazovacího jazyka Azure Digital Twins můžete načíst digitální dvojčata podle jejich...

• Vlastnosti (včetně vlastností značky)
• 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 rozhraní API použít, je použít některou 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 dokumentace ke službě Azure Digital Twins. Můžete také přejít přímo do referenčních částí pomocí následujících odkazů:

• Klauzule
  • SELECT
  • Z
  • ZÁPAS
  • PŘIPOJIT
  • KDE
• Functions
• Operátory
• Vyhrazená klíčová slova

Důležité informace o dotazování

Při psaní dotazů pro Azure Digital Twins mějte na paměti následující skutečnosti:

• Zapamatujte si rozlišování velkých a malých písmen: U všech operací dotazů Azure Digital Twins se rozlišují malá a velká písmena, proto je potřeba použít přesné názvy definované v modelech. Pokud jsou názvy vlastností nesprávně napsané nebo jsou nesprávně velké, je sada výsledků dotazu prázdná a nevracejí se žádné chyby.

• Řídicí jednoduché uvozovky: Pokud text dotazu obsahuje v datech znak jedné uvozovky, bude nutné uvozovky uvozovek uvozovek použít jako \ řídicí znak. 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í DigitalTwins API změny okamžitě odráží, takže pokud potřebujete okamžitou odpověď, použijte k získání dat dvojčat požadavek rozhraní API (DigitalTwins GetById) nebo volání sady SDK (GetDigitalTwin).

Dotazování historizovaných dat dvojčat v průběhu času

Dotazovací jazyk Azure Digital Twins slouží pouze k dotazování na aktuální stav digitálních dvojčat a vztahů.

Pokud chcete spouštět dotazy na grafová data historizovaných dvojčat shromážděná v průběhu času, použijte funkci historie dat a připojte instanci Služby Azure Digital Twins ke clusteru Azure Data Explorer. Tím se automaticky historizují aktualizace grafů do Azure Data Explorer, kde se na tyto aktualizace můžete dotazovat pomocí modulu plug-in Azure Digital Twins pro Azure Data Explorer.

Další kroky

Naučte se psát dotazy a podívejte se na příklady kódu klienta v tématu Dotazování grafu dvojčat.