Condividi tramite

Funzione SAMPLE (DAX)

  • Articolo

Restituire un campione di n righe della tabella specificata.

Sintassi

SAMPLE(<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). Se viene immesso un valore (o un'espressione) di tipo non Integer, viene eseguito il cast del risultato come valore di tipo Integer.

  • table
    Qualsiasi espressione DAX che restituisce una tabella di dati da cui estrarre 'n' righe di esempio.

  • orderBy_expression
    (Facoltativo) Qualsiasi espressione DAX scalare in cui il valore restituito 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

    Dispone l'ordine crescente di order_by.

Valore restituito

Tabella composta da un campione di n righe del parametro table o tabella vuota se il parametro n_value è minore o uguale a 0 (zero). Se vengono specificati argomenti OrderBy, il campione sarà stabile e deterministico e restituirà la prima riga, l'ultima riga e le righe distribuite in modo uniforme tra di esse. Se non viene specificato alcun ordine, il campione sarà casuale, non stabile e non deterministico.

Osservazioni

  • Se n_value è uguale o minore di 0 (zero), SAMPLE restituisce una tabella vuota.

  • Per evitare valori duplicati nel campione, la tabella specificata come secondo argomento deve essere raggruppata in base alla colonna utilizzata per l'ordinamento.