数式で集計関数を使用する

[metrics] (メトリクス) のみでは、各タイムインターバルの入力値を集計し、単一の出力値を算出する次の関数を使用することができます。集計関数は、関連付けられたアセットからデータを集計できません。

集計関数の引数には、変数、数値リテラル、時間関数 、入れ子式、または集計関数を使用することができます。式 max(latest(x), latest(y), latest(z)) は集計関数を引数として使用し、x、y および z プロパティの現在の最大値を返します。

集計関数に入れ子になった式を使用することができます。入れ子になった式を使用する場合、次のルールが適用されます。

• 各引数は1つの変数しか持つことができません。

  例えば、avg(x*(x-1)) と sum(x/2 )/avg(y^2 ) がサポートされています。

  例えば、min(x/y) はサポートされていません。

• 各引数は多段階に入れ子になった式を持つことができる。

  例えば、sum(avg(x^2 )/2) がサポートされています。

• 引数によって、異なる変数を持つことができます。

  例えば、sum(x/2, y*2) がサポートされています。

注記

• 式に測定値が含まれている場合、測定値の現在の時間間隔の最後の値 AWS IoT SiteWise を使用して集計を計算します。

• 式に属性が含まれている場合、 は属性の最新の値 AWS IoT SiteWise を使用して集計を計算します。

機能	説明
avg(x0, ..., xn)	現在の時間間隔における指定された変数値の平均を返します。 この関数は、与えられた変数が現在の時間間隔に少なくとも 1 つのデータポイントを持つ場合にのみデータポイントを出力します。
sum(x0, ..., xn)	現在の時間間隔における指定された変数値の合計を返します。 この関数は、与えられた変数が現在の時間間隔に少なくとも 1 つのデータポイントを持つ場合にのみデータポイントを出力します。
min(x0, ..., xn)	現在の時間間隔における指定された変数の最小値を返します。 この関数は、与えられた変数が現在の時間間隔に少なくとも 1 つのデータポイントを持つ場合にのみデータポイントを出力します。
max(x0, ..., xn)	現在の時間間隔における指定された変数の最大値を返します。 この関数は、与えられた変数が現在の時間間隔に少なくとも 1 つのデータポイントを持つ場合にのみデータポイントを出力します。
count(x0, ..., xn)	現在の時間間隔における指定された変数のデータポイントの合計数を返します。条件を満たすデータポイントの数を数える方法の詳細については、「条件に一致するデータポイントをカウントする」を参照してください。 この関数は、時間間隔ごとにデータポイントを計算します。
stdev(x0, ..., xn)	現在の時間間隔に対する指定された変の数値の標準偏差を返します。 この関数は、与えられた変数が現在の時間間隔に少なくとも 1 つのデータポイントを持つ場合にのみデータポイントを出力します。