本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# PERCENTILE 函數
<a name="percentile"></a>

PERCENTILE 函數用於計算確切的百分位數值，方法是先排序`col`欄中的值，然後在指定的 中尋找值`percentage`。

當您需要計算確切的百分位數值，且運算成本適用於您的使用案例時，PERCENTILE 函數非常有用。它提供比 APPROX\_PERCENTILE 函數更準確的結果，但速度可能較慢，尤其是大型資料集。

相反地，APPROX\_PERCENTILE 函數是更有效率的替代方案，可提供具有指定容錯能力的百分位數值估計值，使其更適合速度優先順序高於絕對精確度的情況。

## 語法
<a name="percentile-syntax"></a>

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

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

 *col*   
您要計算百分位數值的表達式或資料欄。

*百分比*  
您要計算的百分位數值，以介於 0 和 1 之間的值表示。  
例如，0.5 會對應到第 50 個百分位數 （中位數）。

*頻率 *  
選用參數，指定資料`col`欄中每個值的頻率或權重。如果提供，函數會根據每個值的頻率計算百分位數。

## 傳回值
<a name="percentile-returns"></a>

以指定的百分比傳回數值或 ANSI 間隔資料欄 col 的確切百分位數值。

百分比的值必須介於 0.0 和 1.0 之間。

頻率的值應為正整數

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

下列查詢會尋找大於或等於資料`col`欄中值 30% 的值。由於值為 0 和 10，因此第 30 個百分位數為 3.0，因為它是大於或等於資料 30% 的值。

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