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	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 DAX escalar em que o valor de resultado seja avaliado para cada linha de table.
ordem	(Opcional) Um valor que especifica como classificar valores orderBy_expression em ordem crescente ou decrescente: 0 (zero), classifica em ordem decrescente os valores de order_by. 1, classifica em ordem crescente order_by.

Retornar valor

Uma tabela que consiste em uma amostra de N linhas de table ou uma tabela vazia se n_value é menor ou igual a 0 (zero). 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 menor ou igual a 0 (zero), a função 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.