Partilhar via

Função SAMPLE (DAX)

  • Artigo

Retorna um exemplo de N linhas da tabela especificada.

Sintaxe

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

Parâmetros

  • n_value
    O número de linhas a serem retornadas. Ele é qualquer expressão DAX que retorne um único valor escalar, onde a expressão será avaliada várias vezes (para cada linha/contexto). Se um valor não inteiro (ou expressão) for inserido, o resultado será considerado um inteiro.

  • table
    Qualquer expressão DAX que retorna uma tabela de dados de onde as 'n' linhas de exemplo são extraídas.

  • orderBy_expression
    (Opcional) A expressão DAX escalar onde o valor do resultado é avaliado para cada linha da table.

  • order
    (Opcional) Um valor que especifica como classificar valores orderBy_expression, em ordem crescente ou decrescente:

    value

    valor alternativo

    Descrição

    0 (zero)

    FALSE

    Classifica em ordem decrescente de valores de order_by.

    Este é o valor padrão quando o parâmetro order é omitido.

    1

    TRUE

    Classifica em ordem crescente de order_by.

Valor de retorno

Uma tabela que consiste em um exemplo de N linhas de table ou uma tabela vazia se n_value for 0 (zero) ou menos. Se argumentos OrderBy forem fornecidos, o exemplo será estável e determinista, retornando a primeira linha, a última linha e linhas distribuídas uniformemente entre elas. Se nenhuma ordenação for especificada, o exemplo será aleatório, não estável e não determinista.

Comentários

  • Se n_value for 0 (zero) ou menos, SAMPLE retornará uma tabela vazia.

  • Para evitar valores duplicados no exemplo, a tabela fornecida como o segundo argumento deve ser agrupada pela coluna usada na classificação.