アセットプロパティ集計のクエリ - 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。詳細については、「プロパティやその他のアセット (メトリクス) からのデータを集約する」を参照してください。

アセットプロパティの集計 (API)

を使用して、 AWS IoT SiteWise APIアセットプロパティの集計を取得できます。

GetAssetPropertyAggregates オペレーションを使用して、アセットプロパティの集計をクエリします。

アセットプロパティを識別するには、次のいずれかを指定します。

  • データが送信されるアセットプロパティpropertyIdassetIdと 。

  • データストリームのエイリアスである propertyAlias (例えば、/company/windfarm/3/turbine/7/temperature)。このオプションを使用するには、最初にアセットプロパティのエイリアスを設定する必要があります。プロパティエイリアスを設定するには、「」を参照してください産業データストリームをアセットプロパティにマッピングする

また、次の必須パラメータも渡す必要があります。

  • aggregateTypes - 取得する集計のリスト。AVERAGECOUNTMAXIMUMMINIMUMSTANDARD_DEVIATIONSUM のいずれかを指定できます。

  • resolution - メトリクスを取得する時間間隔を指定します。1m (1 分) 、1h (1 時間) 、1d (1 日) のいずれかを指定します。

  • startDate - 履歴データをクエリる範囲の開始点を (Unix エポックタイムで秒単位)。

  • endDate - 履歴データをクエリする範囲の終端を (Unix エポックタイムで秒単位)。

次のパラメータのいずれかを渡して、結果を絞り込むこともできます。

  • maxResults - 1 回のリクエストで返す結果の最大数。デフォルトは 20 結果です。

  • nextToken - このオペレーションの前の呼び出しから返されたページ割りトークン。

  • timeOrdering - 返された値に適用する順序。ASCENDING または DESCENDING

  • qualities – 結果をフィルタリングする品質: GOODBAD または UNCERTAIN

注記

GetAssetPropertyAggregates オペレーションは、このセクションで説明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

    オペレーションは、プロパティTQVsの履歴を含むレスポンスを次の形式で返します。レスポンスには、リクエストされた集計のみが含まれます。

    { "aggregatedValues": [ { "timestamp": Number, "quality": "String", "value": { "average": Number, "count": Number, "maximum": Number, "minimum": Number, "standardDeviation": Number, "sum": Number } } ], "nextToken": "String" }
  2. より多くの値エントリが存在する場合は、ページ割りトークンを nextTokenフィールドから GetAssetPropertyAggregatesオペレーションへの後続の呼び出しに渡すことができます。