Compartilhar via


TOPN

aplica-se a:coluna calculadatabela calculadaMeasurecá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 Número de linhas a ser retornado. Qualquer expressão DAX que retorna um valueescalar, em que 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. Confira 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_Expressionvalues:

- 0 (zero) orFALSE. Classifica em ordem decrescente de values de Order. Padrão quando Order parâmetro é omitido.

- 1 or TRUE. Classifica em ordem crescente de OrderBy.

Retornar value

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

Comentários

  • If há um empate, em Order_Byvalues, na n-th linha da tabela, em seguida, all linhas vinculadas são retornadas. Então, quando houver empates na N-ésima linha, a função poderá retornar mais de n linhas.

  • If N_Value é 0 (zero) or menos, TOPN retorna uma tabela vazia.

  • TOPN not garante qualquer ordem de classificação para os resultados.

  • Essa função not tem suporte para uso no modo DirectQuery quando usada em colunas calculadas or regras de RLS (segurança em nível de linha).

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]
)