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 lze dotazovat za účelem získání informací o digitálních dvojčatech a vztazí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, jak spouštět požadavky na dotazy, najdete v tématu Query the twin graph.

O dotazech

K načtení digitálních dvojčat podle jejich... můžete použít dotazovací jazyk Azure Digital Twins.

• Vlastnosti (včetně vlastností značek)
• Modely
• Vztahy
  • 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ů:

• Klauzule
  • VYBRAT
  • Z
  • UTKÁNÍ
  • PŘIPOJIT
  • KDE
• Funkce
• 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í aspekty:

• Pamatujte na rozlišování malých a velkých písmen: Všechny operace dotazů Azure Digital Twins jsou citlivé na rozlišení malých a velkých písmen, proto dávejte pozor na použití přesných názvů definovaných v modelech. Pokud jsou názvy vlastností špatně napsané nebo s nesprávnou velikostí písmen, sada výsledků je prázdná bez vrácených chyb.

• Ošetření jednoduchých uvozovek: Pokud text dotazu obsahuje znak jednoduché uvozovky, bude nutné jej ošetřit znakem \. Tady je příklad, který se zabývá hodnotou vlastnosti D'Souza:

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

• Pokud ke spouštění dotazů používáte Azure CLI, možná budete muset eskapovat některé další znaky, abyste splnili požadavky různých prostředí. Další informace naleznete v tématu Použití speciálních znaků v různých prostředích.

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, jak psát dotazy a jak zobrazit příklady kódu klienta v Query the twin graph.