

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Função PERCENTILE
<a name="percentile"></a>

A função PERCENTILE é usada para calcular o valor exato do percentil, primeiro classificando os valores na `col` coluna e, em seguida, localizando o valor no especificado. `percentage`

A função PERCENTILE é útil quando você precisa calcular o valor exato do percentil e o custo computacional é aceitável para seu caso de uso. Ela fornece resultados mais precisos do que a função APPROX\$1PERCENTILE, mas pode ser mais lenta, especialmente para grandes conjuntos de dados. 

Por outro lado, a função APPROX\$1PERCENTILE é uma alternativa mais eficiente que pode fornecer uma estimativa do valor do percentil com uma tolerância de erro especificada, tornando-a mais adequada para cenários em que a velocidade é uma prioridade maior do que a precisão absoluta.

## Sintaxe
<a name="percentile-syntax"></a>

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

## Argumentos
<a name="percentile-arguments"></a>

 *resfriado*   
A expressão ou coluna para a qual você deseja calcular o valor do percentil.

*porcentagem*  
O valor do percentil que você deseja calcular, expresso como um valor entre 0 e 1.   
Por exemplo, 0,5 corresponderia ao 50º percentil (mediana).

*frequência*  
Um parâmetro opcional que especifica a frequência ou o peso de cada valor na `col` coluna. Se fornecida, a função calculará o percentil com base na frequência de cada valor.

## Retornos
<a name="percentile-returns"></a>

Retorna o valor percentual exato da coluna numérica ou de intervalo ANSI col na porcentagem fornecida. 

O valor da porcentagem deve estar entre 0,0 e 1,0. 

O valor da frequência deve ser integral positiva

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

A consulta a seguir encontra o valor maior ou igual a 30% dos valores na `col` coluna. Como os valores são 0 e 10, o 30º percentil é 3,0, porque é o valor maior ou igual a 30% dos dados.

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