TOPN

Artigo
12/17/2024

Aplica-se a:Coluna calculada Tabela calculada Measure Cálculo visual

Retorna as N linhas superiores da tabela especificada.

Sintaxe

TOPN(<N_Value>, <Table>, <OrderBy_Expression>, [<Order>[, <OrderBy_Expression>, [<Order>]]…])

Parâmetros

Parâmetro	Definição
`N_Value`	O número de linhas a serem retornadas. Qualquer expressão DAX que retorna uma valueescalar , onde a expressão deve ser avaliada várias vezes (para cada linha/contexto). Consulte Comentários para entender melhor quando o número de linhas retornadas pode ser maior do que `n_value`.
`Table`	Qualquer expressão DAX que retorna uma tabela de dados de onde extrair as linhas 'n' superiores. Consulte Comentários para entender melhor quando uma tabela vazia é retornada.
`OrderBy_Expression`	(Opcional) Qualquer expressão DAX em que o resultado value é usado para classificar a tabela and avaliada para cada linha de `table`.
`Order`	(Opcional) Um value que especifica como classificar `OrderBy_Expression`values: - `0` (zero) or`FALSE`. Classifica em ordem decrescente de values de `Order`. Padrão quando `Order` parâmetro é omitido. - `1` or `TRUE`. Classifica-se por ordem crescente de `OrderBy`.

Regresso value

Uma tabela com as N linhas superiores de Tableor uma tabela vazia ifN_Value é 0 (zero) or menos. As linhas not são classificadas em qualquer ordem específica.

Observações

If houver um empate, em Order_Byvalues, na enésima linha da tabela, então all linhas empatadas são devolvidas. Então, quando há laços na N-ésima linha, a função pode retornar mais de n linhas.
If N_Value for 0 (zero) or menos, TOPN retorna uma tabela vazia.
TOPN not garante qualquer ordem de classificação para os resultados.
Esta função not é suportada para uso no modo DirectQuery quando usada em colunas calculadas or regras de segurança em nível de linha (RLS).

Exemplo

A fórmula de measure a seguir retorna os 10 principais produtos vendidos por valor de vendas.

= SUMX(
        TOPN(
            10, 
            SUMMARIZE(
                    InternetSales, 
                    InternetSales[ProductKey], 
                    "TotalSales", SUM(InternetSales[SalesAmount])
            ),
            [TotalSales], DESC
        ),
        [TotalSales]
)

Partilhar via