Compartilhar via


SAMPLE

aplica-se a:coluna calculadatabela calculadamedidacálculo visual

Retorna um exemplo 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 expressão) 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 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.

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 menor. Se os argumentos OrderBy forem fornecidos, o exemplo será estável e determinístico, retornando a primeira linha, a última linha e linhas distribuídas uniformemente entre eles. Se nenhuma ordenação for especificada, o exemplo será aleatório, não estável e não determinístico.

Comentários

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

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

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