翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# PERCENTILE 関数
<a name="percentile"></a>

PERCENTILE 関数は、最初に`col`列内の値をソートし、次に指定された で値を検索することで、正確なパーセンタイル値を計算するために使用します`percentage`。

PERCENTILE 関数は、正確なパーセンタイル値を計算する必要があり、計算コストがユースケースで許容できる場合に役立ちます。APPROX\$1PERCENTILE 関数よりも正確な結果が得られますが、特に大規模なデータセットでは時間がかかる場合があります。

対照的に、APPROX\$1PERCENTILE 関数は、指定されたエラー耐性を持つパーセンタイル値の推定値を提供できる、より効率的な代替手段であり、絶対精度よりも速度が優先度が高いシナリオに適しています。

## 構文
<a name="percentile-syntax"></a>

```
percentile(col, percentage [, frequency])
```

## 引数
<a name="percentile-arguments"></a>

 *コール*   
パーセンタイル値を計算する式または列。

*パーセンテージ*  
計算するパーセンタイル値。0～1 の値で表されます。  
たとえば、0.5 は 50 パーセンタイル (中央値) に対応します。

*頻度 *  
`col` 列内の各値の頻度または重みを指定するオプションのパラメータ。指定した場合、関数は各値の頻度に基づいてパーセンタイルを計算します。

## 戻り値
<a name="percentile-returns"></a>

数値または ANSI 間隔の列列の正確なパーセンタイル値を指定されたパーセンテージで返します。

パーセンテージの値は 0.0 から 1.0 の間でなければなりません。

頻度の値は正の整数である必要があります

## 例
<a name="percentile-example"></a>

次のクエリは、 `col`列の値の 30% 以上の値を検索します。値は 0 と 10 であるため、30 パーセンタイルはデータの 30% 以上の値であるため、3.0 です。

```
SELECT percentile(col, 0.3) FROM VALUES (0), (10) AS tab(col);
 3.0
```