azure_digital_twins_query_request 外掛程式
適用於： ✅Microsoft網狀架構✅Azure 數據總管
外掛程式會在 azure_digital_twins_query_request Kusto 查詢語言 （KQL） 查詢中執行 Azure Digital Twins 查詢。 外掛程式是使用運算子叫 evaluate 用的。
使用外掛程式，您可以查詢 Azure Digital Twins 中的數據，以及可透過 KQL 存取的任何數據源。 例如，您可以 執行時間序列分析。
如需外掛程式的詳細資訊，請參閱 Azure Digital Twins 查詢外掛程式。
語法
evaluateazure_digital_twins_query_request ( AdtInstanceEndpoint , AdtQuery )
深入瞭解 語法慣例。
參數
| 姓名 | 類型 | 必要 | 描述 |
|---|---|---|---|
| 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 的數據歷程記錄整合功能來記錄數位對應項屬性更新。 若要瞭解如何檢視歷程記錄對應項更新，請參閱 檢視歷程記錄對應項更新