Azure Digital Twins 查詢語言

  • 發行項

本文說明查詢語言及其功能的基本概念。 讓我們回想一下，Azure Digital Twins 的中心是透過數位對應項和關聯性所建構出的對應項圖表。 查詢此圖表，即可取得其所包含數位對應項和關聯性的相關資訊。 這些查詢是以類似 SQL 的自訂查詢語言撰寫，稱為「Azure Digital Twins 查詢語言」。 此語言類似於具有許多相似功能的 IoT 中樞查詢語言。

如需查詢語法及如何執行查詢要求的詳細範例，請參閱查詢對應項圖表。

關於查詢

您可以使用 Azure Digital Twins 查詢語言，根據下列項目來擷取數位對應項：

  • 屬性 (包括標籤屬性)
  • 模型
  • 關聯性
    • 關聯性的屬性

為了將查詢從用戶端應用程式提交至服務，您將使用 Azure Digital Twins 查詢 API。 若要使用此 API，其中一種方式是透過 Azure Digital Twins 的其中一個 SDK。

參考文件

您可以在 Azure Digital Twins 文件左側目錄的 [參考] 下方找到查詢語言參考。 您也可以使用下列連結直接移至參考區段：

查詢的考量

在撰寫 Azure Digital Twins 的查詢時，請記住下列考量：

  • 記得區分大小寫：所有 Azure Digital Twins 查詢作業都會區分大小寫，因此請小心使用模型中所定義的確切名稱。 如果屬性名稱拼錯或大小寫不正確，則結果集會是空的，而且不會傳回任何錯誤。

  • 逸出單引號：如果您的查詢文字在資料中包含單引號字元，則必須使用 \ 字元來逸出引號。 以下是會處理 D'Souza 屬性值的範例：

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

注意

變更圖表中的資料之後，最多可能會有 10 秒的延遲，變更才會反映在查詢中。

DigitalTwins API 會立即反映變更，所以如果您需要立即回應，請使用 API 要求 (DigitalTwins GetById) 或 SDK 呼叫 (GetDigitalTwin) 來取得對應項資料，而不是使用查詢。

查詢指定期間內的歷程記錄對應項資料

Azure Digital Twins 查詢語言只適用於查詢數位對應項和關聯性的目前狀態。

若要在經過一段時間收集的歷程記錄對應項圖形資料上執行查詢，請使用資料歷程記錄功能，將您的 Azure Digital Twins 實例連線到Azure Data Explorer叢集。 這會自動將圖表更新歷程記錄至 Azure Data Explorer，您可以在其中使用適用于 Azure Data Explorer 的 Azure Digital Twins 外掛程式來查詢它們。

下一步

了解如何撰寫查詢，並查看查詢對應項圖形中的用戶端程式碼範例。