quantilesTimingIf

描述

If 组合器可以应用于 quantilesTiming 函数，使用 quantilesTimingIf 聚合组合器函数来计算满足条件为 true 的行的耗时值分位数。

使用示例

在这个示例中，我们将创建一个表，用于存储不同接口端点的 API 响应时间， 并使用 quantilesTimingIf 来计算成功请求的响应时间分位数。

CREATE TABLE api_responses(
    endpoint String,
    response_time_ms UInt32,
    is_successful UInt8
) ENGINE = Log;

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（第一四分位数）
• 0.5（中位数）
• 0.75（第三四分位数）
• 0.95（第 95 百分位数）
• 0.99（第 99 百分位数）
• 1.0（最大值）

   ┌─端点─┬─响应时间分位数─────────────────────────────────────────────┐
1. │ 订单     │ [82, 87, 92, 98, 103, 104, 105]                                     │
2. │ 产品     │ [45, 47, 49, 51, 52, 52, 53]                                        │
3. │ 用户     │ [nan, nan, nan, nan, nan, nan, nan]                                 │
   └──────────┴─────────────────────────────────────────────────────────────────────┘

另请参阅

• quantilesTiming
• If 组合器