查詢資產屬性彙總 - AWS IoT SiteWise
資產屬性的彙總 () API資產屬性的彙總 ()AWS CLI

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

查詢資產屬性彙總

AWS IoT SiteWise 自動計算彙總的資產屬性值，這是一組根據多個時間間隔計算的基本量度。 AWS IoT SiteWise 針對資產屬性，每分鐘、每小時和每天計算下列彙總：

  • 平均值 — 時間間隔內屬性值的平均值 (平均值)。

  • count — 一段時間間隔內屬性的資料點數目。

  • 最大值 — 一段時間間隔內屬性值的最大值。

  • 最小值 — 一段時間間隔內屬性值的最小值。

  • 標準差 — 屬性值在時間間隔內的標準差。

  • sum — 一段時間間隔內屬性值的總和。

對於非數值屬性 (例如字串和布林值) 只 AWS IoT SiteWise 會計算計數彙總。

您也可以為您的資產資料計算自訂指標。使用量度屬性，您可以定義作業特定的彙總。量度屬性提供未預先計算的其他彙總函數和時間間隔。 AWS IoT SiteWise API如需詳細資訊，請參閱彙總屬性和其他資產 (量度) 的資料。

資產屬性的彙總 () API

您可以使用 AWS IoT SiteWise API取得資產屬性的彙總。

使用此GetAssetPropertyAggregates作業查詢資產屬性的彙總。

若要識別資產性質，請指定下列其中一項：

  • 資料傳送至propertyId的資產屬性的assetId和。

  • 的propertyAlias，它是一個數據流別名（例如，/company/windfarm/3/turbine/7/temperature）。若要使用這個選項，您必須先設定您的資產屬性別名。若要設定性質別名，請參閱將工業資料流對映至資產屬性。

您還必須傳遞下列必要參數：

  • aggregateTypes-要檢索的聚合列表。您可以指定 AVERAGE、COUNT、MAXIMUM、MINIMUM、STANDARD_DEVIATION 和 SUM 中的任何一個。

  • resolution— 擷取量度的時間間隔：1m(1 分鐘)、1h (1 小時) 或 1d (1 天)。

  • startDate— 查詢歷史資料的範圍獨佔開始，以 Unix 紀元時間為單位，以秒表示。

  • endDate— 要查詢歷史資料的範圍結束 (以 Unix 紀元時間為單位)，以秒表示。

您也可以傳遞下列任一參數來精簡結果：

  • maxResults— 在一個請求中傳回的結果數目上限。預設為20結果。

  • nextToken-先前呼叫此作業所傳回的分頁記號。

  • timeOrdering— 要套用至傳回值的順序：ASCENDING或DESCENDING。

  • qualities— 篩選結果的品質：GOODBAD、或UNCERTAIN。

注意

GetAssetPropertyAggregates作業傳回的格式TQV與本節中描述的其他作業不同的格式。value 結構包含適用於該請求中每個 aggregateTypes 的欄位。timestamp 包含彙總發生的時間，以 Unix epoch 時間的秒計算。

資產屬性的彙總 ()AWS CLI

若要查詢資產屬性的彙總 ()AWS CLI

  1. 執行下列命令以取得資產屬性的彙總。此命令會查詢特定 1 小時間隔的 1 小時解析度的平均值和總和。Replace (取代) asset-id 使用資產的 ID 和 property-id 與屬性的 ID。使用要查詢的彙總和間隔取代參數。

    aws iotsitewise get-asset-property-aggregates \
  --asset-id asset-id \
  --property-id property-id \
  --start-date 1575216000 \
  --end-date 1575219600 \
  --aggregate-types AVERAGE SUM \
  --resolution 1h

    此作業會傳回包含下列格式TQVs之屬性歷史記錄的回應。回應只包括請求的彙總。

    {
  "aggregatedValues": [
    {
      "timestamp": Number,
      "quality": "String",
      "value": {
        "average": Number,
        "count": Number,
        "maximum": Number,
        "minimum": Number,
        "standardDeviation": Number,
        "sum": Number
      }
    }
  ],
  "nextToken": "String"
}

  2. 如果存在更多值項目，您可以將分頁 Token 從nextToken欄位傳遞至後續呼叫GetAssetPropertyAggregates作業。