azure_digital_twins_query_request 外掛程式

外掛程式會在 azure_digital_twins_query_request Kusto 查詢語言 (KQL) 查詢中執行 Azure Digital Twins 查詢。 使用 evaluate 運算子叫用外掛程式。

使用外掛程式，您可以查詢 Azure Digital Twins 中的數據，以及可透過 KQL 存取的任何數據源。 例如，您可以 執行時間序列分析。

如需外掛程式的詳細資訊，請參閱適用於 Azure Data Explorer 的 Azure Digital Twins 查詢外掛程式。

語法

evaluateazure_digital_twins_query_request(AdtInstanceEndpoint,AdtQuery)

深入瞭解 語法慣例。

參數

名稱	類型	必要	Description
AdtInstanceEndpoint	string	✔️	要查詢的 Azure Digital Twins 實例端點。
AdtQuery	string	✔️	要針對 Azure Digital Twins 端點執行的查詢。 此查詢是以 Azure Digital Twins 的自定義類似 SQL 查詢語言撰寫，稱為 Azure Digital Twins 查詢語言。 如需詳細資訊，請參閱 Azure Digital Twins 的查詢語言。

驗證與授權

外掛程式azure_digital_twins_query_request會使用執行查詢之使用者的 Microsoft Entra 帳戶進行驗證。 若要執行查詢，使用者至少必須獲授與 Azure Digital Twins 資料讀者角色。 您可以在 Azure Digital Twins 解決方案的安全性中找到如何指派此角色的相關資訊。

範例

下列範例會示範如何執行各種 Azure Digital Twins 查詢，包括使用其他 Kusto 運算式的查詢。

擷取 Azure Digital Twins 執行個體內的所有對應項。

下列範例會傳回 Azure Digital Twins 執行個體內的所有數位對應項。

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

將對應項屬性投射為資料行以及其他 Kusto 運算式

下列範例會傳回外掛程式的結果作為個別資料行，然後使用 Kusto 運算式來執行其他作業。

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

輸出

TemperatureInC	溼度
21	48
49	34
80	32

執行時間序列分析

您可以使用 Azure Digital Twins 的數據歷程記錄整合功能來記錄數位對應項屬性更新。 若要瞭解如何檢視歷程記錄對應項更新，請參閱在 Azure Data Explorer 中檢視歷程記錄對應項更新