SAMPLE

Aplica-se a:Coluna calculadaTabela calculadaMeasureCálculo visual

Retorna um sample 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 uma única valueescalar , onde a expressão deve ser avaliada várias vezes (para cada linha/contexto). If um value não inteiro (expressãoor) é inserido, o resultado é convertido como um inteiro.
table	Qualquer expressão DAX que retorna uma tabela de dados de onde extrair as linhas 'n' sample.
orderBy_expression	Qualquer expressão DAX escalar em que o resultado value é avaliado para cada linha de table.
order	(Opcional) Um value que especifica como classificar orderBy_expressionvalues, ascendente or descendente: 0 (zero), classifica em ordem decrescente de values de order_by. 1, classifica-se por ordem crescente de order_by.

Regresso value

Uma tabela que consiste em uma sample de N linhas de tableor uma tabela vazia ifn_value é 0 (zero) or menos. If OrderBy os argumentos forem fornecidos, a sample será estável and determinística, retornando a linha first, a linha lastand linhas uniformemente distribuídas entre elas. If nenhuma ordem for especificada, o sample será aleatório, not estável andnot determinístico.

Observações

• If n_value é 0 (zero) or menos que SAMPLE retorna uma tabela vazia.

• Para evitar values duplicados no sample, a tabela fornecida como argumento second deve ser agrupada pela coluna usada para classificação.

• Esta função not é suportada para uso no modo DirectQuery quando usada em colunas calculadas or regras de segurança em nível de linha (RLS).