在公式運算式中使用變數

變數代表公式運算式中的 AWS IoT SiteWise 資產屬性。使用變數輸入運算式中其他資產屬性的值，以便您可以處理來自常數屬性 (屬性)、原始資料串流 (度量) 和其他公式屬性的資料。

變數可以表示來自相同資產模型或關聯子資產模型的資產性質。只有量度公式可以從子資產模型輸入變數。

您可以在控制台和 API 中通過不同的名稱來識別變量。

• AWS IoT SiteWise 控制台 — 使用資產屬性名稱作為表達式中的變量。

• AWS IoT SiteWise API（AWS CLI， AWS SDK）— 使用結構定義變量，該ExpressionVariable結構需要變量名稱和對資產屬性的引用。變數名稱可以包含小寫字母、數字和底線。然後，使用變數名稱來參考運算式中的資產屬性。

變數名稱區分大小寫。

如需詳細資訊，請參閱定義轉換和定義量度。

使用變數來參考屬性

變數的值會定義其所參考的屬性。 AWS IoT SiteWise 提供了不同的方法來做到這一點。

• 按屬性 ID：您可以指定屬性的唯一 ID (UUID) 來識別它。

• 依名稱：如果屬性位於同一資產模型上，您可以在屬性 ID 欄位中指定其名稱。

• 按路徑：變量值可以通過其路徑引用屬性。如需詳細資訊，請參閱 使用路徑參考自訂複合模型性質。

注意

AWS IoT SiteWise 控制台不支持變量。它們由 AWS IoT SiteWise API 使用，包括 AWS Command Line Interface AWS CLI）和 AWS SDK。

您在回應中收到的變數 AWS IoT SiteWise 包含有關該值的完整資訊，包括 ID 和路徑。

但是，當您將變量傳遞到 AWS IoT SiteWise （例如，在「創建」或「更新」調用中）時，只需指定其中一個變量。例如，如果您指定路徑，則不需要提供 ID。