SAMPLE
aplica-se a:coluna calculada
tabela calculada
medida
cá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).