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á.

# rank
<a name="rank-function"></a>

A função `rank` calcula a classificação de uma medida ou uma dimensão em comparação com as partições especificadas. Ele conta cada item, inclusive duplicações, uma vez e atribui um nível "com buracos" para compensar os valores duplicados. 

## Sintaxe
<a name="rank-function-syntax"></a>

São necessários colchetes. Para ver quais argumentos são opcionais, consulte as seguintes descrições.

```
rank
(
  [ sort_order_field ASC_or_DESC, ... ]
  ,[ partition_field, ... ] 
)
```

## Argumentos
<a name="rank-function-arguments"></a>

 *campo da ordem de classificação*   
Uma ou mais medidas e dimensões agregadas pelas quais deseja classificar os dados, separadas por vírgulas. Você pode especificar a ordem de classificação crescente (**ASC**) ou decrescente (**DESC**).   
Cada campo na lista está entre chaves (\$1\$1), caso seja mais de uma palavra. A lista completa está entre colchetes ([ ]).

 *campo de partição*   
(Opcional) Uma ou mais dimensões pelas quais deseja particionar, separadas por vírgulas.   
Cada campo na lista está entre chaves (\$1\$1), caso seja mais de uma palavra. A lista completa está entre colchetes ([ ]).

 *nível de cálculo*  
(Opcional) Especifica o nível de cálculo a ser usado:  
+ **`PRE_FILTER`**: os cálculos de pré-filtro são computados antes dos filtros do conjunto de dados.
+ **`PRE_AGG`**: os cálculos pré-agregados são computados antes da aplicação de agregações e dos filtros *N* superiores e inferiores aos elementos visuais.
+ **`POST_AGG_FILTER`**: (Padrão) os cálculos de tabelas são computados quando os elementos visuais são exibidos. 
Esse valor será padronizado como `POST_AGG_FILTER` quando for deixado em branco. Para obter mais informações, consulte [Usando cálculos com reconhecimento de nível no Quick](https://docs.aws.amazon.com/quicksight/latest/user/level-aware-calculations.html).

## Exemplo
<a name="rank-function-example"></a>

O exemplo a seguir classifica `max(Sales)`, com base em uma ordem de classificação decrescente, por `State` e `City`, em `State` de **WA**. Quaisquer cidades com o mesmo `max(Sales)` recebem o mesmo nível, mas o próximo nível inclui a contagem de todos os níveis existentes anteriormente. Por exemplo, se três cidades compartilham o mesmo nível, a quarta cidade é classificada como quarta. 

```
rank
(
  [max(Sales) DESC], 
  [State, City]
)
```

O exemplo a seguir classifica `max(Sales)`, com base em uma ordem de classificação crescente, por `State`. Quaisquer estados com o mesmo `max(Sales)` recebem o mesmo nível, mas o próximo nível inclui a contagem de todos os níveis existentes anteriormente. Por exemplo, se três estados compartilham o mesmo nível, o quarto estado é classificado como quarto. 

```
rank
(
  [max(Sales) ASC], 
  [State]
)
```

O exemplo a seguir classifica `Customer Region` pela `Billed Amount` total. Os campos dos cálculos de tabela estão nas fontes de campos do visual.

```
rank(
  [sum({Billed Amount}) DESC]
)
```

A captura de tela a seguir mostra os resultados do exemplo, junto com a `Billed Amount` total, para que você possa ver como cada região é classificada.

![\[alt text not found\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/images/rankCalc.png)