Ler em inglês

Compartilhar via


SAMPLE

Aplica-se a:Coluna calculadaTabela calculadaMedidaCálculo visual

Retorna uma amostra de N linhas da tabela especificada.

Sintaxe

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

Parâmetros

Termo Definição
n_value Número de linhas a ser retornado. É qualquer expressão DAX que retorna um único valor escalar, em que a expressão deve ser avaliada várias vezes (para cada linha/contexto). Se um valor não inteiro (ou uma expressão) for inserido(a), o resultado será convertido em um inteiro.
table Qualquer expressão DAX que retorna uma tabela de dados das quais extrair 'n' linhas de amostra.
orderBy_expression Qualquer expressão ESCALAR DAX em que o valor do resultado é avaliado para cada linha de table.
order (Opcional) Um valor que especifica como classificar orderBy_expression valores, crescentes ou decrescentes: 0 (zero), classifica em ordem decrescente de valores de order_by. 1, classifica-se em ordem crescente de order_by.

Retornar valor

Uma tabela que consiste em uma amostra de N linhas de table ou uma tabela vazia se n_value for 0 (zero) ou menor. Se forem fornecidos argumentos de OrderBy, a amostra será estável e determinística, retornando a primeira linha, a última linha e as linhas igualmente distribuídas entre elas. Se nenhuma ordem for especificada, a amostra será aleatória, não estável e não determinística.

Comentários

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

  • Para evitar valores duplicados na amostra, a tabela fornecida como segundo argumento deverá ser agrupada pela coluna usada para classificação.

  • Não há suporte para a função ser usada no modo DirectQuery quando usada em regras RLS (segurança em nível de linha) ou colunas calculadas.