Ler em inglês

Compartilhar via


RANK

Aplica-se a:Coluna calculadaTabela calculadaMedidaCálculo visual

Retorna a classificação do contexto atual na partição especificada, classificada de acordo com a ordem especificada. Se não for possível encontrar uma correspondência, a classificação ficará em branco.

Sintaxe

RANK ( [<ties>][, <relation> or <axis>][, <orderBy>][, <blanks>][, <partitionBy>][, <matchBy>][, <reset>] )

Parâmetros

Termo Definição
empates (Opcional) Define como lidar com a classificação quando duas ou mais linhas estão vinculadas.
Se especificado, o valor com suporte será DENSE ou SKIP.
Se omitido:
– É padronizado para SKIP
relação (Opcional) Uma expressão de tabela da qual a linha de saída é retornada.
Se especificado, todas as colunas em <orderBy> e <partitionBy> deverão vir dela.
Se omitido:
– <orderBy> deve ser especificado explicitamente.
– Todas as colunas <orderBy> e <partitionBy> devem ser totalmente qualificadas e vir de uma única tabela.
– O padrão é ALLSELECTED() de todas as colunas em <orderBy> e <partitionBy>.
axis (Opcional) Um eixo na forma visual. Disponível apenas em cálculos visuais e substitui a <relação>.
orderBy (Opcional) Uma cláusula ORDERBY() que contém as colunas que definem como cada partição é classificada.
Se omitido:
– <relation> deve ser especificado explicitamente.
– O padrão é ordenar por cada coluna em <relation> que ainda não está especificada em <partitionBy>.
em branco (Opcional) Uma enumeração que define como manipular valores em branco durante a classificação.
Os valores com suporte são:
  • KEEP (o valor padrão), em que o comportamento de valores numéricos são valores em branco, ordenados entre valores zero e negativos. O comportamento das cadeias de caracteres é que os valores em branco são ordenados antes de todas as cadeias de caracteres, incluindo cadeias de caracteres vazias.
  • FIRST, os espaços em branco são sempre ordenados no início, independentemente da ordem de classificação crescente ou decrescente.
  • LAST, os espaços em branco são sempre ordenados no fim, independentemente da ordem de classificação crescente ou decrescente.

Observe que, quando o parâmetro <blanks> e os espaços em branco na função ORDERBY() na expressão individual são especificados, os <espaços em branco> na expressão orderBy individuais têm prioridade para a expressão orderBy relevante e as expressões orderBy sem <espaços em branco> especificados respeitarão o parâmetro <blanks> na função Windowdow pai.
partitionBy (Opcional) Uma cláusula PARTITIONBY() que contém as colunas que definem como <relation> é particionado.
Se omitida, <relation> será tratada como uma única partição.
matchBy (Opcional) Uma cláusula MATCHBY() que contém as colunas que definem como corresponder dados e identificar a linha atual.
reset (Opcional) Disponível apenas no cálculos visuais. Indica se o cálculo será redefinido e em que nível da hierarquia de colunas da forma visual. Os valores aceitos são: NONE, LOWESTPARENT, HIGHESTPARENT, ou um inteiro. O comportamento depende do sinal do número inteiro:
- Se for zero ou omitido, o cálculo não será redefinido. Equivalente a NONE.
- Se positivo, o inteiro identificará a coluna começando pela mais alta, independentemente da granularidade. HIGHESTPARENT é equivalente a 1.
- Se negativo, o inteiro identificará a coluna a partir da mais baixa, em relação à granularidade atual. LOWESTPARENT é equivalente a -1.

Valor retornado

O número de classificação do contexto atual.

Comentários

  • Cada coluna <orderBy>, <partitionBy> w <matchBy> deve ter um valor externo correspondente para ajudar a definir a linha atual na qual operar, com o seguinte comportamento:

    • Se houver exatamente uma coluna externa correspondente, seu valor será usado.
    • Se não houver nenhuma coluna externa correspondente:
      • RANK determinará primeiro todas as colunas <orderBy>, <partitionBy> e <matchBy> que não têm uma coluna externa correspondente.
      • Para cada combinação de valores existentes dessas colunas no contexto pai de RANK, RANK é avaliado e uma linha é retornada.
      • A saída final de RANK é um número de classificação.
  • Se <matchBy> estiver presente, RANK tentará usar colunas em <matchBy> e <partitionBy> para dividir a linha atual.

  • Se as colunas especificadas em <orderBy> e <partitionBy> não puderem identificar exclusivamente cada linha em <relation>, duas ou mais linhas poderão ter a mesma classificação e ela será determinada pelo parâmetro de vínculos.

  • RANK retorna um valor em branco para o total de linhas. É recomendado testar a expressão completamente.

  • RANK não se compara a RANKX da mesma forma que SUM se compara a SUMX.

  • <reset> só pode ser usado em cálculos visuais e não pode ser usado em combinação com <orderBy> ou <partitionBy>. Se <redefinir> estiver presente, o <eixo> poderá ser especificado, mas a <relação> não.

Exemplo 1: coluna calculada

A seguinte consulta DAX:

EVALUATE
ADDCOLUMNS(
    'DimGeography',
    "Rank",
    RANK(
    	DENSE,
    	'DimGeography',
    	ORDERBY(
    		'DimGeography'[StateProvinceName], desc,
    		'DimGeography'[City], asc),
        LAST,
    	PARTITIONBY(
    		'DimGeography'[EnglishCountryRegionName])))
ORDER BY [EnglishCountryRegionName] asc, [StateProvinceName] desc, [City] asc

Retorna uma tabela que classifica cada geografia com o mesmo EnglishCountryRegionName, de acordo com os respectivos StateProvinceName e City. Os valores da coluna <orderBy> em branco são classificados no final.

Exemplo 2 – cálculo visual

As seguintes consultas DAX de cálculo visual:

SalesRankWithinYear = RANK(DENSE, ORDERBY([SalesAmount], DESC), PARTITIONBY([CalendarYear]))

SalesRankAllHistory = RANK(DENSE, ORDERBY([SalesAmount], DESC))

Crie duas colunas que classificam cada mês pelo total de vendas, ambas dentro de cada ano, e todo o histórico.

A captura de tela abaixo mostra a matriz visual e a primeira expressão de cálculo visual:

Cálculo visual do DAX

INDEX
ORDERBY
PARTITIONBY
WINDOW
ROWNUMBER