メインコンテンツまでスキップ
メインコンテンツまでスキップ

sumSimpleState

説明

SimpleState コンビネータは sum 関数に適用でき、すべての入力値の合計を返します。結果は SimpleAggregateFunction タイプで返されます。

使用例

上昇票と下降票の追跡

投稿に対する票を追跡するテーブルを使用した実用例を見てみましょう。各投稿について、上昇票、下降票、および全体スコアの累計を維持したいと考えています。SimpleAggregateFunction タイプを使用した sum は、集計の全状態を保持するのではなく、累計のみを保存するため、このユースケースに適しています。その結果、処理が高速になり、部分的な集計状態のマージが不要になります。

まず、生データ用のテーブルを作成します:

CREATE TABLE raw_votes
(
    post_id UInt32,
    vote_type Enum8('upvote' = 1, 'downvote' = -1)
)
ENGINE = MergeTree()
ORDER BY post_id;

次に、集計データを保存するターゲットテーブルを作成します:

CREATE TABLE vote_aggregates
(
    post_id UInt32,
    upvotes SimpleAggregateFunction(sum, UInt64),
    downvotes SimpleAggregateFunction(sum, UInt64),
    score SimpleAggregateFunction(sum, Int64)
)
ENGINE = AggregatingMergeTree()
ORDER BY post_id;

その後、SimpleAggregateFunction タイプのカラムを持つマテリアライズドビューを作成します:

CREATE MATERIALIZED VIEW mv_vote_processor TO vote_aggregates
AS
SELECT
  post_id,
  -- Initial value for sum state (1 if upvote, 0 otherwise)
  toUInt64(vote_type = 'upvote') AS upvotes,
  -- Initial value for sum state (1 if downvote, 0 otherwise)
  toUInt64(vote_type = 'downvote') AS downvotes,
  -- Initial value for sum state (1 for upvote, -1 for downvote)
  toInt64(vote_type) AS score
FROM raw_votes;

サンプルデータを挿入します:

INSERT INTO raw_votes VALUES
    (1, 'upvote'),
    (1, 'upvote'),
    (1, 'downvote'),
    (2, 'upvote'),
    (2, 'downvote'),
    (3, 'downvote');

SimpleState コンビネータを使用してマテリアライズドビューにクエリを実行します:

SELECT
  post_id,
  sum(upvotes) AS total_upvotes,
  sum(downvotes) AS total_downvotes,
  sum(score) AS total_score
FROM vote_aggregates -- Query the target table
GROUP BY post_id
ORDER BY post_id ASC;
┌─post_id─┬─total_upvotes─┬─total_downvotes─┬─total_score─┐
│       1 │             2 │               1 │           1 │
│       2 │             1 │               1 │           0 │
│       3 │             0 │               1 │          -1 │
└─────────┴───────────────┴─────────────────┴─────────────┘

参照