quantileExact 関数

quantileExact

数値データ列の分位数を正確に計算します。

正確な値を取得するために、渡されたすべての値は配列に結合され、その後部分的にソートされます。したがって、この関数は O(n) のメモリを消費します。ここで、n は渡された値の数です。ただし、少数の値に対しては、この関数は非常に効果的です。

クエリ内で異なるレベルを持つ複数の quantile* 関数を使用する場合、内部状態は組み合わされません（つまり、クエリは本来可能なより効率的に動作しません）。この場合は、quantiles 関数を使用してください。

構文

quantileExact(level)(expr)

エイリアス: medianExact。

引数

• level — 分位数のレベル。オプションのパラメータ。0から1までの定数浮動小数点数。[0.01, 0.99] の範囲内の level 値の使用をお勧めします。デフォルト値: 0.5。level=0.5 の場合、この関数は中央値を計算します。
• expr — 列値に対する式で、数値のdata types、Date または DateTime を返します。

返される値

• 指定されたレベルの分位数。

タイプ:

• 数値データ型の場合、出力フォーマットは入力フォーマットと同じになります。例:

SELECT
    toTypeName(quantileExact(number)) AS `quantile`,
    toTypeName(quantileExact(number::Int32)) AS `quantile_int32`,
    toTypeName(quantileExact(number::Float32)) AS `quantile_float32`,
    toTypeName(quantileExact(number::Float64)) AS `quantile_float64`,
    toTypeName(quantileExact(number::Int64)) AS `quantile_int64`
FROM numbers(1)


   ┌─quantile─┬─quantile_int32─┬─quantile_float32─┬─quantile_float64─┬─quantile_int64─┐
1. │ UInt64   │ Int32          │ Float32          │ Float64          │ Int64          │
   └──────────┴────────────────┴──────────────────┴──────────────────┴────────────────┘

1 行の結果。経過時間: 0.002 秒。

• 入力値が Date 型の場合は、Date。
• 入力値が DateTime 型の場合は、DateTime。

例

クエリ:

SELECT quantileExact(number) FROM numbers(10)

結果:

┌─quantileExact(number)─┐
│                     5 │
└───────────────────────┘

quantileExactLow

quantileExact と似ており、数値データ列の正確な分位数を計算します。

正確な値を得るために、渡されたすべての値が配列に結合され、その後完全にソートされます。ソートアルゴリズムの計算量は O(N·log(N)) であり、ここで N = std::distance(first, last) の比較です。

返される値は分位数のレベルと選択された要素の数に依存します。つまり、レベルが0.5の場合、偶数個の要素に対しては下の中央値を返し、奇数個の要素に対しては中間中央値を返します。中央値は python で使用されるmedian_lowの実装と同様に計算されます。

他のすべてのレベルの場合、level * size_of_array の値に対応するインデックスの要素が返されます。例:

SELECT quantileExactLow(0.1)(number) FROM numbers(10)

┌─quantileExactLow(0.1)(number)─┐
│                             1 │
└───────────────────────────────┘

クエリ内で異なるレベルを持つ複数の quantile* 関数を使用する場合、内部状態は組み合わされません（つまり、クエリは本来可能なより効率的に動作しません）。この場合は、quantiles 関数を使用してください。

構文

quantileExactLow(level)(expr)

エイリアス: medianExactLow。

引数

• level — 分位数のレベル。オプションのパラメータ。0から1までの定数浮動小数点数。[0.01, 0.99] の範囲内の level 値の使用をお勧めします。デフォルト値: 0.5。level=0.5 の場合、この関数は中央値を計算します。
• expr — 列値に対する式で、数値のdata types、Date または DateTime を返します。

返される値

• 指定されたレベルの分位数。

タイプ:

• 数値データ型入力の場合はFloat64。
• 入力値が Date 型の場合は、Date。
• 入力値が DateTime 型の場合は、DateTime。

例

クエリ:

SELECT quantileExactLow(number) FROM numbers(10)

結果:

┌─quantileExactLow(number)─┐
│                        4 │
└──────────────────────────┘

quantileExactHigh

quantileExact と似ており、数値データ列の正確な分位数を計算します。

渡されたすべての値は配列に結合され、その後完全にソートされて、正確な値が得られます。ソートアルゴリズムの計算量は O(N·log(N)) であり、ここで N = std::distance(first, last) の比較です。

返される値は分位数のレベルと選択された要素の数に依存します。つまり、レベルが0.5の場合、偶数個の要素に対しては上の中央値を返し、奇数個の要素に対しては中間中央値を返します。中央値は python で使用されるmedian_highの実装と同様に計算されます。他のすべてのレベルの場合、level * size_of_array の値に対応するインデックスの要素が返されます。

この実装は現在の quantileExact 実装と全く同じように動作します。

クエリ内で異なるレベルを持つ複数の quantile* 関数を使用する場合、内部状態は組み合わされません（つまり、クエリは本来可能なより効率的に動作しません）。この場合は、quantiles 関数を使用してください。

構文

quantileExactHigh(level)(expr)

エイリアス: medianExactHigh。

引数

• level — 分位数のレベル。オプションのパラメータ。0から1までの定数浮動小数点数。[0.01, 0.99] の範囲内の level 値の使用をお勧めします。デフォルト値: 0.5。level=0.5 の場合、この関数は中央値を計算します。
• expr — 列値に対する式で、数値のdata types、Date または DateTime を返します。

返される値

• 指定されたレベルの分位数。

タイプ:

• 数値データ型入力の場合はFloat64。
• 入力値が Date 型の場合は、Date。
• 入力値が DateTime 型の場合は、DateTime。

例

クエリ:

SELECT quantileExactHigh(number) FROM numbers(10)

結果:

┌─quantileExactHigh(number)─┐
│                         5 │
└───────────────────────────┘

quantileExactExclusive

数値データ列の分位数を正確に計算します。

正確な値を取得するために、渡されたすべての値は配列に結合され、その後部分的にソートされます。したがって、この関数は O(n) のメモリを消費します。ここで、n は渡された値の数です。ただし、少数の値に対しては、この関数は非常に効果的です。

この関数は、Excel 関数のPERCENTILE.EXCに相当します（タイプ R6）。

異なるレベルを持つ複数の quantileExactExclusive 関数をクエリ内で使用する場合、内部状態は組み合わされません（つまり、クエリは本来可能なより効率的に動作しません）。この場合は、quantilesExactExclusive 関数を使用してください。

構文

quantileExactExclusive(level)(expr)

引数

• expr — 列値に対する式で、数値のdata types、Date または DateTime を返します。

パラメータ

• level — 分位数のレベル。オプション。可能な値: (0, 1) — 境界を含まない。デフォルト値: 0.5。level=0.5 の場合、この関数は中央値を計算します。Float。

返される値

• 指定されたレベルの分位数。

タイプ:

• 数値データ型入力の場合はFloat64。
• 入力値が Date 型の場合は、Date。
• 入力値が DateTime 型の場合は、DateTime。

例

クエリ:

CREATE TABLE num AS numbers(1000);

SELECT quantileExactExclusive(0.6)(x) FROM (SELECT number AS x FROM num);

結果:

┌─quantileExactExclusive(0.6)(x)─┐
│                          599.6 │
└────────────────────────────────┘

quantileExactInclusive

数値データ列の分位数を正確に計算します。

正確な値を取得するために、渡されたすべての値は配列に結合され、その後部分的にソートされます。したがって、この関数は O(n) のメモリを消費します。ここで、n は渡された値の数です。ただし、少数の値に対しては、この関数は非常に効果的です。

この関数は、Excel 関数のPERCENTILE.INCに相当します（タイプ R7）。

異なるレベルを持つ複数の quantileExactInclusive 関数をクエリ内で使用する場合、内部状態は組み合わされません（つまり、クエリは本来可能なより効率的に動作しません）。この場合は、quantilesExactInclusive 関数を使用してください。

構文

quantileExactInclusive(level)(expr)

引数

• expr — 列値に対する式で、数値のdata types、Date または DateTime を返します。

パラメータ

• level — 分位数のレベル。オプション。可能な値: [0, 1] — 境界を含む。デフォルト値: 0.5。level=0.5 の場合、この関数は中央値を計算します。Float。

返される値

• 指定されたレベルの分位数。

タイプ:

• 数値データ型入力の場合はFloat64。
• 入力値が Date 型の場合は、Date。
• 入力値が DateTime 型の場合は、DateTime。

例

クエリ:

CREATE TABLE num AS numbers(1000);

SELECT quantileExactInclusive(0.6)(x) FROM (SELECT number AS x FROM num);

結果:

┌─quantileExactInclusive(0.6)(x)─┐
│                          599.4 │
└────────────────────────────────┘

関連項目

• median
• quantiles