Funzione TOPN (DAX)

  • Articolo

Vengono restituite le prime n righe della tabella specificata.

Sintassi

TOPN(<n_value>, <table>, <orderBy_expression>, [<order>[, <orderBy_expression>, [<order>]]…])

Parametri

  • n_value
    Numero di righe da restituire. Qualsiasi espressione DAX tramite cui viene restituito un singolo valore scalare, dove l'espressione deve essere valutata più volte (per ogni riga/contesto).

    Per informazioni sui casi in cui il numero di righe restituito può essere maggiore del parametro n_value, vedere la sezione relativa alle osservazioni.

    Per informazioni sui casi in cui viene restituita una tabella vuota, vedere la sezione relativa alle osservazioni.

  • table
    Qualsiasi espressione DAX tramite cui viene restituita una tabella di dati dalla quale estrarre le prime n righe.

  • orderBy_expression
    (Facoltativo) Qualsiasi espressione DAX in cui il valore risultante viene utilizzato per ordinare la tabella e viene valutato per ogni riga del parametro table.

  • order
    (Facoltativo) Valore che consente di specificare la modalità di ordinamento dei valori orderBy_expression, ovvero crescente o decrescente:

    valore

    Valore alternativo

    Descrizione

    0 (zero)

    FALSE

    Ranghi in ordine decrescente dei valori di order_by.

    Si tratta del valore predefinito quando il parametro order viene omesso.

    1

    TRUE

    Ranghi in ordine crescente di order_by.

Valore restituito

Tabella con le prime n righe del parametro table o tabella vuota se il parametro n_value è minore o uguale a 0 (zero). Le righe non sono necessariamente ordinate in un ordine particolare.

Osservazioni

  • Se è disponibile un valore equivalente, nei valori order_by, in corrispondenza dell'ennesima riga della tabella, vengono restituite tutte le righe equivalenti. Quindi, in caso di valori equivalenti disponibili in corrispondenza dell'ennesima riga, tramite la funzione potrebbe essere restituito un numero di righe maggiore di n.

  • Se n_value è uguale o minore di 0 (zero), tramite TOPN viene restituita una tabella vuota.

  • TOPN non consente di garantire alcun ordinamento per i risultati.

Esempio

Nell'esempio seguente viene creata una misura con le vendite dei primi 10 prodotti venduti.

=SUMX(TOPN(10, SUMMARIZE(Product, [ProductKey], “TotalSales”, SUMX(RELATED(InternetSales_USD[SalesAmount_USD]), InternetSales_USD[SalesAmount_USD]) + SUMX(RELATED(ResellerSales_USD[SalesAmount_USD]), ResellerSales_USD[SalesAmount_USD]))