Função VALUES (DAX)

Retorna uma tabela de uma coluna que contém os valores distintos da coluna especificada. Em outras palavras, valores duplicados são removidos e apenas valores exclusivos são retornados.

Observação
Esta função não pode ser usada para retornar valores para uma célula ou coluna de uma planilha; em vez disso, use-a como uma função intermediária, aninhada em uma fórmula, para obter uma lista de valores distintos que podem ser contados, ou usada para filtrar ou somar outros valores.

Sintaxe

VALUES(<column>)

Parâmetros

Termo	Definição
column	A coluna da qual valores exclusivos devem ser retornados.

Valor de retorno

Uma coluna de valores exclusivos.

Comentários

Quando você usa a função VALUES em um contexto que foi filtrado, como em uma Tabela Dinâmica, os valores exclusivos retornados por VALUES são afetados pelo filtro. Por exemplo, se você filtrar por Região, e retornar uma lista dos valores para Cidade, a lista incluirá apenas as cidades das regiões permitidas pelo filtro. Para retornar todas as cidades, sejam quais forem os filtros existentes, use a função ALL para remover filtros da tabela. O segundo exemplo demonstra o uso de ALL com VALUES.

Funções relacionadas

Na maioria dos cenários, os resultados da função VALUES são idênticos aos da função DISTINCT. Ambas as funções removem duplicatas e retornam uma lista dos possíveis valores na coluna especificada. Entretanto, a função VALUES também pode retornar um Membro desconhecido. Este valor desconhecido é útil em casos onde você está verificando valores distintos de uma tabela relacionada, mas um valor usado na relação está ausente em uma tabela. Na terminologia de banco de dados, isto é chamado de violação de integridade referencial. Tais incompatibilidades em dados podem ocorrer facilmente quando uma tabela é atualizada, mas não a tabela relacionada.

A tabela a seguir resume as incompatibilidades entre dados que podem ocorrer em duas tabelas relacionadas quando a integridade referencial não é preservada.

tabela MyOrders	tabela MySales
1 de junho	Vendas de 1 de junho
2 de junho	Vendas de 2 de junho
(nenhuma data de pedido foi inserida)	Vendas de 3 de junho

Se você usou a função DISTINCT para retornar uma lista de datas da Tabela Dinâmica que contém estas tabelas, apenas duas datas serão retornadas. Entretanto, se você usar a função VALUES, a função retornará as duas datas mais um membro em branco adicional. Além disso, qualquer linha da tabela MySales que não tenha uma data correspondente na tabela MyOrders será associada a este membro desconhecido.

Exemplo

A fórmula a seguir conta o número de faturas exclusivas (pedidos de venda) e produz os resultados a seguir quando usada em um relatório que inclui os Nomes da Categoria do Produto:

Rótulos de linha	Count Invoices
Accessories	18,208
Bikes	15,205
Clothing	7,461
Grand Total	27,659

=COUNTROWS(VALUES('InternetSales_USD'[SalesOrderNumber]))

Consulte também

Referência

Função FILTER (DAX)

Função COUNTROWS (DAX)

Outros recursos

Funções de filtro (DAX)