彙總屬性和其他資產 (量度) 的資料 - AWS IoT SiteWise
定義指標 (主控台)定義量度 (AWS CLI)

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

彙總屬性和其他資產 (量度) 的資料

指標是使用彙總函數來處理所有輸入資料點，並在指定的時間間隔輸出單一資料點的數學運算式。例如，指標可以從溫度資料串流計算每小時平均溫度。

指標可以從關聯資產的指標輸入資料，因此您可以計算統計資料，以提供您的操作或操作子集的深入解析。例如，指標可以計算風力發電場中所有風力發電機的平均每小時溫度。如需如何定義資產之間關聯的詳細資訊，請參閱 定義資產模型階層。

指標也可以從其他屬性輸入資料，而不會在每個時間間隔內彙總資料。如果您在方程式中指定屬性，則會在計算方程式時 AWS IoT SiteWise 使用該屬性的最新值。如果您在公式中指定測量結果，則 AWS IoT SiteWise 會使用最後一個值作為計算公式的時間間隔。這意味著您可以定義相同資產模型上的所Performance有其他指標 AvailabilityQuality，例OEE = Availability * Quality * Performance如，位置，以及所有其他指標。

AWS IoT SiteWise 也會自動計算所有資產屬性的一組基本彙總量度。若要降低運算成本，您可以使用這些彙總，而不要為基本運算定義自訂指標。如需詳細資訊，請參閱查詢資產屬性彙總。

定義指標 (主控台)

在 AWS IoT SiteWise 主控台中定義資產模型的量度時，請指定下列參數：

  • 名稱 — 屬性的名稱。

  • 資料類型 — 轉換的資料類型，可以是「雙精度」或「字串」。

  • 外部 ID — (選用) 這是使用者定義的 ID。如需詳細資訊，請參閱《AWS IoT SiteWise 使用者指南》中的 使用外部參考物件 IDs。

  • 公式 — 量度表示式。量度運算式可以使用彙總函數，為階層中所有關聯資產的屬性輸入資料。開始輸入或按向下箭頭鍵開啟 auto 完成功能。如需詳細資訊，請參閱使用公式運算式。

    重要

    度量只能是整數、雙精度、布林值或字串類型的屬性。布爾值轉換為0（假）和1（真）。

    如果您在指標表達式中定義任何指標輸入變數，則這些輸入必須和輸出指標有相同的時間間隔。

    公式運算式只能輸出雙精度值或字串值。巢狀運算式可以輸出其他資料類型 (例如字串)，但整體公式必須評估為數字或字串。您可以使用 jp 函數將字串轉換為數字。布林值必須是 1 (真) 或 0 (假)。如需詳細資訊，請參閱未定義、無限和溢出值。

  • 時間間隔 — 測量結果時間間隔。 AWS IoT SiteWise 支持以下翻滾窗口時間間隔，其中每個間隔在前一個結束時開始：

    • 1 分鐘 — 1 分鐘，在每分鐘結束時計算（上午 12:00:00，凌晨 12:01，凌晨 12 點 2 分鐘，依此類推）。

    • 5 分鐘 — 5 分鐘，在每五分鐘結束時計算一次，從小時開始（凌晨 12：00：00，上午 12:05，上午 12 點 10 分鐘等）。

    • 15 分鐘至 15 分鐘，於每十五分鐘結束時計算一次（上午 12 時 00 分、凌晨 12 時 15 分、凌晨 12 時 30 分鐘等）。

    • 1 小時 — 1 小時 (60 分鐘)，在每小時結束時計算 UTC (凌晨 12 時 00 分、凌晨 1 時 00 分、凌晨 2 時 00 分等)。

    • 1 天 — 1 天（24 小時），在每天結束時計算UTC（星期一上午 12:00:00，星期二凌晨 12 點 00 分，依此類推）。

    • 1 週 — 1 週（7 天），在每個星期日結束時計算UTC（每個星期一上午 12:00:00）。

    • 自訂間隔 — 您可以輸入一分鐘到一週之間的任何時間間隔。

  • 偏移日期 — (選擇性) 彙總資料的參照日期。

  • 偏移時間 — (選擇性) 彙總資料的參照時間。偏移時間必須介於凌晨 12 時至 59 時之間。

  • 時區時差 — (選擇性) 偏移量的時區。如果未指定，則預設的偏移時區為世界協調時間 (UTC)。

    • (UTC+00:00) 世界協調時間

    • 歐洲中部時間 UTC

    • (UTC+ 2：00) 東歐

    • 非UTC洲東部時間

    • (UTC+ 凌晨 4 點) 近東時間

    • (UTC+ 05:00) 巴基斯坦拉合爾時間

    • 印度標準時間 UTC

    • 孟加拉國標準時間 UTC

    • 越南標準時間 UTC

    • (UTC+ 08:00) 中國台灣台時間

    • 日本標準時間 UTC

    • (UTC+ 09:30) 澳大利亞中部時間

    • (UTC+ 10:00) 澳大利亞東部時間

    • （UTC+ 11:00）所羅門標準時間

    • 新西蘭標準時間 UTC

    • (UTC-11:00) 中途島時間

    • 夏UTC威夷標準時間

    • (UTC-09:00) 阿拉斯加標準時間

    • (UTC-08:00) 太平洋標準時間

    • (UTC-07:00) 鳳凰城標準時間

    • （UTC-06:00）中部標準時間

    • 東部標準時間 UTC

    • (UTC-04:00) 波多黎各和美屬維爾京群島時間

    • （UTC-凌晨 3 點）阿根廷標準時間

    • (UTC-02:00) 南喬治亞時間

    • （UTC-凌晨 1 時）中非時間

範例 具有偏移量的自定義時間間隔（控制台）

下列範例說明如何定義 12 小時的時間間隔，並在 2021 年 2 月 20 日下午 6:30:30 () 進行偏移。PST

使用偏移定義自訂間隔的步驟

  1. 選擇「自訂間隔」做為「時間間隔」。

  2. 針對「時間間隔」，執行下列任一項作業：

    • 輸入12，然後選擇「小時」。

    • 輸入720，然後選擇分鐘。

    • 輸入43200，然後選擇秒數。

    重要

    無論單位為何，時間間隔都必須是整數。

  3. 對於抵銷日期，請選擇 2021/02/20。

  4. 對於 「偏移時間」，輸入18:30:30。

  5. 對於 「偏移時區」，請選擇 (UTC-08:00) 太平洋標準時間。

如果您在 2021 年 7 月 1 日下午 6 時 30 分之前或下午 6 時 30 分 (PST) 建立量度，則您會在 2021 年 7 月 1 日下午 6 時 30 分 () 取得第一個彙總結果。PST第二個彙總結果是在 2021 年 7 月 2 日上午 6 時 30 分（PST），依此類推。

定義量度 (AWS CLI)

使用定義資產模型的度量時 AWS IoT SiteWise API，您可以指定下列參數：

  • name— 屬性的名稱。

  • dataType— 指標的資料類型，可以是DOUBLE或STRING。

  • externalId— (選用) 這是使用者定義的 ID。如需詳細資訊，請參閱《AWS IoT SiteWise 使用者指南》中的 使用外部參考物件 IDs。

  • expression— 量度運算式。量度運算式可以使用彙總函數，為階層中所有關聯資產的屬性輸入資料。如需詳細資訊，請參閱使用公式運算式。

  • window— 量度翻滾視窗的時間間隔和偏移量，其中每個間隔在前一個間隔結束時開始：

    • interval— 翻滾視窗的時間間隔。時間間隔必須介於一分鐘到一週之間。

    • offsets— 翻轉視窗的偏移量。

    如需詳細資訊，請參閱〈AWS IoT SiteWise API參考〉TumblingWindow中的〈〉。

    範例 具有偏移量的自定義時間間隔（AWS CLI）

    下列範例說明如何定義 12 小時的時間間隔，並在 2021 年 2 月 20 日下午 06:30:30 () 進行偏移。PST

    
{
    "window": {
        "tumbling": {
            "interval": "12h",
            "offset": " 2021-07-23T18:30:30-08"
        }
    }
}

    如果您在 2021 年 7 月 1 日下午 6 時 30 分之前或下午 6 時 30 分 (PST) 建立量度，則您會在 2021 年 7 月 1 日下午 6 時 30 分 () 取得第一個彙總結果。PST第二個彙總結果是在 2021 年 7 月 2 日上午 6 時 30 分（PST），依此類推。

  • variables— 變數清單，定義要在運算式中使用的資產或子資產的其他屬性。每個變數結構都包含可在表達式中使用的簡單名稱，以及一個 value 結構，用來識別要連結到該變數的屬性。value 結構包含以下資訊：

    • propertyId— 要從中提取值的屬性 ID。如果屬性已在目前的模型中定義 (而非在階層中的模型內定義)，您可以使用屬性的名稱而非其 ID。

    • hierarchyId— (選擇性) 要從中查詢屬性之子資產的階層 ID。您可以使用階層定義的名稱，而非其 ID。如果省略此值， AWS IoT SiteWise 會在目前模型中尋找屬性。

    重要

    度量只能是整數、雙精度、布林值或字串類型的屬性。布爾值轉換為0（假）和1（真）。

    如果您在指標表達式中定義任何指標輸入變數，則這些輸入必須和輸出指標有相同的時間間隔。

    公式運算式只能輸出雙精度值或字串值。巢狀運算式可以輸出其他資料類型 (例如字串)，但整體公式必須評估為數字或字串。您可以使用 jp 函數將字串轉換為數字。布林值必須是 1 (真) 或 0 (假)。如需詳細資訊，請參閱未定義、無限和溢出值。

  • unit— (選擇性) 性質的科學單位，例如 mm 或攝氏度。

範例 指標定義範例

下列範例示範彙總資產溫度衡量值的指標屬性，以計算每小時華氏溫度上限。此物件是包含「測量結果」 的範例。AssetModelProperty您可以將此物件指定為CreateAssetModel要求承載的一部分，以建立度量屬性。如需詳細資訊，請參閱建立資產模型 (AWS CLI)。


{
      ...
      "assetModelProperties": [
      ...
      {
        "name": "Max temperature",
        "dataType": "DOUBLE",
        "type": {
          "metric": {
            "expression": "max(temp_f)",
            "variables": [
              {
                "name": "temp_f",
                "value": {
                  "propertyId": "Temperature F"
                }
              }
            ],
            "window": {
              "tumbling": {
                "interval": "1h"
              }
            }
          }
        },
        "unit": "Fahrenheit"
      }
    ],
    ...
}
範例 從關聯資產輸入資料的量度定義範例

以下範例示範了一個公制性質，該屬性彙總了多個風力發電機的平均功率資料，以計算風電場的總平均功率。此物件是包含「測量結果」 的範例。AssetModelProperty您可以將此物件指定為CreateAssetModel要求承載的一部分，以建立度量屬性。

{
      ...
      "assetModelProperties": [
      ...
      {
          "name": "Total Average Power",
          "dataType": "DOUBLE",
          "type": {
            "metric": {
              "expression": "avg(power)",
              "variables": [
                {
                  "name": "power",
                  "value": {
                    "propertyId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE",
                    "hierarchyId": "Turbine Asset Model"
                  }
                }
              ],
              "window": {
                "tumbling": {
                  "interval": "5m"
                }
              }
            }
        },
        "unit": "kWh"
      }
    ],
    ...
}