SAMPLE

Aplica-se a:Coluna calculadaTabela calculadaMedidaCálculo visual

Retorna uma amostra de N linhas da tabela especificada.

Sintaxe

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

Parâmetros

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

Valor de retorno

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

Observações

• 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 deve ser agrupada pela coluna usada para classificação.

• Esta função não é suportada para utilização no modo DirectQuery quando utilizada em colunas calculadas ou regras de segurança ao nível da linha (RLS).