windowSum
windowSum 関数は、指定された属性でパーティション化およびソートされたカスタムウィンドウ内の集計されたメジャーの合計を計算します。通常、ビジュアルにメトリクスと日付フィールドが表示される時系列でカスタムウィンドウ関数を使用します。
ウィンドウ関数は、8 以前の MySQL バージョンおよび 10.2 以前の MariaDB バージョンではサポートされていません。
構文
括弧が必要です。省略可能な引数については、次の説明を参照してください。
windowSum (measure,[sort_order_field ASC/DESC, ...],start_index,end_index,[ partition_field, ... ])
引数
- メジャー
-
合計を取得する集計されたメトリクス (例:
sum({Revenue}))。MySQL と互換性のある MySQL、MariaDB、および Amazon Aurora の場合、ルックアップインデックスは 1 のみに制限されます。ウィンドウ関数は、8 より下の MySQL バージョンおよび 10.2 以前の MariaDB バージョンではサポートされていません。
- sort attribute
-
データをソートする 1 つ以上の集計フィールド (測定またはディメンション、またはその両方)。コンマで区切って入力します。昇順 (
ASC) または降順 (DESC) のソート順を指定できます。複数の単語の場合は、リスト内の各フィールドを {} (中括弧) で囲みます。リスト全体は [ ] (角括弧) で囲まれます。
- start index
-
開始インデックスは正の整数で、現在の行から n 行上を示します。開始インデックス は、実際の期間を数えるのではなく、現在の行より上の利用可能なデータポイントを数えます。データがまばらである (たとえば、月や年がない) 場合は、それに応じてインデックスを調整します。
- end index
-
終了インデックスは正の整数で、現在の行から n 行下を示します。終了インデックスは、実際の期間を数えるのではなく、現在の行より下の利用可能なデータポイントを数えます。データがまばらである (たとえば、月や年がない) 場合は、それに応じてインデックスを調整します。
- partition field
-
(省略可能) パーティション分割する 1 つ以上の測定およびディメンション。コンマで区切って入力します。
複数の単語の場合は、リスト内の各フィールドを {} (中括弧) で囲みます。リスト全体は [ ] (角括弧) で囲まれます。
例
次の例では、sum(Revenue) の移行の合計を計算し、SaleDate でソートします。計算には、現在の行の上 2 行と下 1 行が含まれます。
windowSum ( sum(Revenue), [SaleDate ASC], 2, 1 )
次の例では、過去 12 か月間の合計が表示されます。
windowSum(sum(Revenue),[SaleDate ASC],12,0)
この過去 12 か月間の合計の例の結果を次のスクリーンショットで示します。sum(Revenue) フィールドがチャートに追加され、収益と過去 12 か月の合計収益の差が表示されます。
