quantilesTimingIf

quantilesTimingIf コンビネータの使用例

​

説明

If コンビネータは quantilesTiming 関数に適用でき、quantilesTimingIf aggregate コンビネータ 関数を使用して、 条件が true の行について時間値の分位点を計算できます。

​

使用例

この例では、異なるエンドポイントに対するAPIの応答時間を格納するテーブルを作成し、 成功したリクエストの応答時間の分位点を計算するために quantilesTimingIf を使用します。

Query

CREATE TABLE api_responses(
    endpoint String,
    response_time_ms UInt32,
    is_successful UInt8
) ENGINE = MergeTree
ORDER BY ();

INSERT INTO api_responses VALUES
    ('orders', 82, 1),
    ('orders', 94, 1),
    ('orders', 98, 1),
    ('orders', 87, 1),
    ('orders', 103, 1),
    ('orders', 92, 1),
    ('orders', 89, 1),
    ('orders', 105, 1),
    ('products', 45, 1),
    ('products', 52, 1),
    ('products', 48, 1),
    ('products', 51, 1),
    ('products', 49, 1),
    ('products', 53, 1),
    ('products', 47, 1),
    ('products', 50, 1),
    ('users', 120, 0),
    ('users', 125, 0),
    ('users', 118, 0),
    ('users', 122, 0),
    ('users', 121, 0),
    ('users', 119, 0),
    ('users', 123, 0),
    ('users', 124, 0);

SELECT
    endpoint,
    quantilesTimingIf(0, 0.25, 0.5, 0.75, 0.95, 0.99, 1.0)(response_time_ms, is_successful = 1) as response_time_quantiles
FROM api_responses
GROUP BY endpoint;

quantilesTimingIf 関数は、成功したリクエスト (is_successful = 1) のみを対象に分位点を計算します。 返される配列には、次の分位点がこの順序で格納されます。

• 0 (最小値)
• 0.25 (第1四分位点)
• 0.5 (中央値)
• 0.75 (第3四分位点)
• 0.95 (95パーセンタイル)
• 0.99 (99パーセンタイル)
• 1.0 (最大値)

Response

   ┌─endpoint─┬─response_time_quantiles─────────────────────────────────────────────┐
1. │ orders   │ [82, 87, 92, 98, 103, 104, 105]                                     │
2. │ products │ [45, 47, 49, 51, 52, 52, 53]                                        │
3. │ users    │ [nan, nan, nan, nan, nan, nan, nan]                                 │
   └──────────┴─────────────────────────────────────────────────────────────────────┘

​

関連項目

• quantilesTiming
• If コンビネータ