翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# でアセットプロパティの集計をクエリする AWS IoT SiteWise
AWS IoT SiteWise は、集計されたアセットプロパティ値を自動的に計算します。これは、複数の時間間隔で計算される一連の基本メトリクスです。 は、アセットプロパティに対して 1 分、1 時間、および 1 日ごとに次の集計を AWS IoT SiteWise 計算します。
+ **[average]** (平均) - 時間間隔におけるプロパティ値の平均 (中間)。
+ **[count]** (カウント) - 時間間隔におけるプロパティのデータポイント数
+ **[maximum]** (最大) - 時間間隔におけるプロパティの最大値。
+ **[minimum]** (最小) - 時間間隔におけるプロパティの最小値。
+ **[standard deviation]** (標準偏差) - 時間間隔におけるプロパティ値の標準偏差。
+ **[sum]** (合計) - 時間間隔におけるプロパティ値の合計。
文字列やブール値などの数値以外のプロパティの場合、 はカウント集計のみを AWS IoT SiteWise 計算します。
アセットデータのカスタムメトリクスを計算することもできます。メトリクスプロパティを使用して、オペレーション固有の集計を定義します。メトリクスプロパティは、 AWS IoT SiteWise API 用に事前計算されていない追加の集計関数と時間間隔を提供します。詳細については、「[プロパティおよびその他のアセットからのデータを集計する (メトリクス)](metrics.md)」を参照してください。
**Topics**
+ [アセットプロパティの集計 (API)](#aggregates-api)
+ [アセットプロパティの集計 (AWS CLI)](#aggregates-cli)
## アセットプロパティの集計 (API)
AWS IoT SiteWise API を使用して、アセットプロパティの集計を取得します。
[GetAssetPropertyAggregates](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_GetAssetPropertyAggregates.html) オペレーションを使用して、アセットプロパティの集計をクエリします。
アセットプロパティを特定するには、次のいずれかを指定します。
+ データが送信されるアセットプロパティの `assetId` と `propertyId`。
+ データストリームのエイリアスである `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 エポックタイムで秒単位)。
+ `endDate` - 履歴データをクエリする範囲の終端を (Unix エポックタイムで秒単位)。
次のパラメータのいずれかを渡して、結果を絞り込むこともできます。
+ `maxResults` - 1 回のリクエストで返す結果の最大数。デフォルトは `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 エポック時間) が含まれます。
## アセットプロパティの集計 (AWS CLI)
**アセットプロパティの集計をクエリするには (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」を参照してください。カウントを除くすべての統計は、文字列 TQVs の統計と同様に`null`レスポンスになります。クエリ範囲にダブルタイプ TQVs`Double.NaN`が含まれている場合、カウントを除くすべての計算は になります`Double.NaN`。