azure_digital_twins_query_request beépülő modul

A azure_digital_twins_query_request beépülő modul egy Azure Digital Twins-lekérdezést futtat egy Kusto lekérdezésnyelv (KQL) lekérdezés részeként. A beépülő modul meghívása az evaluate operátorral történik.

A beépülő modul használatával az Azure Digital Twinsben és a KQL-n keresztül elérhető adatforrásokban is lekérdezheti az adatokat. Elvégezheti például az idősorozat-elemzést.

További információ a beépülő modulról: Azure Digital Twins lekérdezési beépülő modul az Azure Data Explorer.

Syntax

evaluateazure_digital_twins_query_request(AdtInstanceEndpoint,AdtQuery)

További információ a szintaxis konvenciókról.

Paraméterek

Név	Típus	Kötelező	Leírás
AdtInstanceEndpoint	string	✔️	A lekérdezendő Azure Digital Twins-példány végpontja.
AdtQuery	string	✔️	Az Azure Digital Twins-végponton futtatandó lekérdezés. Ez a lekérdezés az Azure Digital Twins egyéni SQL-szerű lekérdezési nyelvével, az Úgynevezett Azure Digital Twins lekérdezési nyelvvel van megírva. További információ: Az Azure Digital Twins lekérdezési nyelve.

Hitelesítés és engedélyezés

A azure_digital_twins_query_request beépülő modul a lekérdezést futtató felhasználó Microsoft Entra fiókját használja a hitelesítéshez. Lekérdezés futtatásához a felhasználónak legalább Azure Digital Twins-adatolvasó szerepkört kell biztosítani. A szerepkör hozzárendelésével kapcsolatos információk az Azure Digital Twins biztonsági megoldásaiban találhatók.

Példák

Az alábbi példák bemutatják, hogyan futtathat különböző Azure Digital Twins-lekérdezéseket, beleértve a további Kusto-kifejezéseket használó lekérdezéseket is.

Az összes ikerpéldány lekérése egy Azure Digital Twins-példányon belül

Az alábbi példa egy Azure Digital Twins-példányon belüli összes digitális ikerpéldányt visszaadja.

evaluate azure_digital_twins_query_request(
  'https://contoso.api.wcus.digitaltwins.azure.net',
  'SELECT T AS Twins FROM DIGITALTWINS T')

Ikertulajdonságok leképezése oszlopokként, valamint további Kusto-kifejezések

Az alábbi példa a beépülő modul eredményét külön oszlopként adja vissza, majd további műveleteket hajt végre Kusto-kifejezésekkel.

evaluate azure_digital_twins_query_request(
  'https://contoso.api.wcus.digitaltwins.azure.net',
  'SELECT T.Temperature, T.Humidity FROM DIGITALTWINS T WHERE IS_PRIMITIVE(T.Temperature) AND IS_PRIMITIVE(T.Humidity)')
| where Temperature > 20
| project TemperatureInC = Temperature, Humidity

Kimenet

TemperatureInC	Páratartalom
21	48
49	34
80	32

Idősorozat-elemzés végrehajtása

Az Azure Digital Twins adatelőzmény-integrációs funkciójával tárolhatja a digitális ikerpéldányok tulajdonságfrissítéseit. A historizált ikerpéldány-frissítések megtekintéséről a Historizált ikerpéldány-frissítések megtekintése az Azure-Data Explorer