> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-fix-nav-issues.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# quantilesTimingIf

> quantilesTimingIf コンビネータの使用例

<div id="description">
  ## 説明
</div>

[`If`](/ja/reference/functions/aggregate-functions/combinators#-if) コンビネータは [`quantilesTiming`](/ja/reference/functions/aggregate-functions/quantileTiming)
関数に適用でき、`quantilesTimingIf` aggregate コンビネータ 関数を使用して、
条件が true の行について時間値の分位点を計算できます。

<div id="example-usage">
  ## 使用例
</div>

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

```sql title="Query" theme={null}
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 title="Response" theme={null}
   ┌─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]                                 │
   └──────────┴─────────────────────────────────────────────────────────────────────┘
```

<div id="see-also">
  ## 関連項目
</div>

* [`quantilesTiming`](/ja/reference/functions/aggregate-functions/quantileTiming)
* [`If コンビネータ`](/ja/reference/functions/aggregate-functions/combinators#-if)