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

# 在 中查詢資產屬性彙總 AWS IoT SiteWise
<a name="aggregates"></a>

AWS IoT SiteWise 會自動計算彙總的資產屬性值，這是在多個時間間隔內計算的一組基本指標。 會為您的資產屬性 AWS IoT SiteWise 計算下列每分鐘、每小時和每天彙總：
+ **平均值** – 屬性值在時間間隔內的平均值 （平均值）。
+ **count** – 屬性在時間間隔內的資料點數目。
+ **maximum** – 時間間隔內屬性值的最大值。
+ minimum**** – 時間間隔內屬性值的最小值。
+ **標準差** – 屬性值在時間間隔內的標準差。
+ sum**** – 屬性在時間間隔內值的總和。

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

您也可以為您的資產資料計算自訂指標。使用指標屬性，您可以定義 操作特有的彙總。指標屬性提供未針對 AWS IoT SiteWise API 預先計算的額外彙總函數和時間間隔。如需詳細資訊，請參閱[從屬性和其他資產彙總資料 （指標）](metrics.md)。

**Topics**
+ [彙總資產屬性 (API)](#aggregates-api)
+ [彙總資產屬性 (AWS CLI)](#aggregates-cli)

## 彙總資產屬性 (API)
<a name="aggregates-api"></a>

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

使用 [GetAssetPropertyAggregates](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_GetAssetPropertyAggregates.html) 操作來查詢資產屬性的彙總。

若要識別資產屬性，請指定下列其中一項：
+ 資料傳送到的資產屬性`propertyId`的 `assetId`和 。
+ `propertyAlias`，這是資料串流別名 （例如 `/company/windfarm/3/turbine/7/temperature`)。若要使用這個選項，您必須先設定您的資產屬性別名。若要設定屬性別名，請參閱 [管理 的資料串流 AWS IoT SiteWise](manage-data-streams.md)。

您必須傳遞下列必要參數：
+ `aggregateTypes` – 要擷取的彙總清單。您可以指定 `AVERAGE`、`COUNT`、`MAXIMUM`、`MINIMUM`、`STANDARD_DEVIATION` 和 `SUM` 中的任何一個。
+ `resolution` – 擷取指標的時間間隔：`1m`(1 分鐘）、`15m`(15 分鐘）、`1h`(1 小時） 或 `1d`(1 天）。
+ `startDate` – 查詢歷史資料範圍的專屬起點，以秒為單位，以 Unix epoch 時間表示。
+ `endDate` – 查詢歷史資料範圍的包含端點，以秒為單位，以 Unix epoch 時間表示。

您也可以傳遞下列任一參數來精簡結果：
+ `maxResults` – 在單一請求中傳回的結果數目上限。預設為`20`結果。
+ `nextToken` – 從此操作的上一個呼叫傳回的分頁字符。
+ `timeOrdering` – 要套用至傳回值的排序： `ASCENDING`或 `DESCENDING`。
+ `qualities` – 篩選結果的品質：`GOOD`、 `BAD`或 `UNCERTAIN`。

**注意**  
[GetAssetPropertyAggregates](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_GetAssetPropertyAggregates.html) 操作會傳回與本區段所述操作以外之不同格式的 TQV。`value` 結構包含適用於該請求中每個 `aggregateTypes` 的欄位。`timestamp` 包含彙總發生的時間，以 Unix epoch 時間的秒計算。

## 彙總資產屬性 (AWS CLI)
<a name="aggregates-cli"></a>

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

1. 執行下列命令以取得資產屬性的彙總。此命令會查詢特定 1 小時間隔的 1 小時解析度的平均值和總和。將 {{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}}
   ```

   此操作會傳回回應，其中包含以下格式的屬性歷史 TQV。回應只包括請求的彙總。

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

1. 如果存在更多值項目，您可以將分頁字符從 `nextToken` 欄位傳遞至後續呼叫 [GetAssetPropertyAggregates](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_GetAssetPropertyAggregates.html) 操作。

**注意**  
 如果您的查詢範圍包含`null`值 TQVs，請參閱 [AssetPropertyValue](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_AssetPropertyValue.html) API。計數以外的所有統計資料都會產生`null`回應，類似於字串 TQVs統計資料。如果您的查詢範圍包含`Double.NaN`雙重類型 TQVs則計數以外的所有計算都會產生 `Double.NaN`。