Partilhar via


VALORES

Aplica-se a: Coluna calculada Tabela calculada Medida Cálculo visual

Quando o parâmetro de entrada é um nome de coluna, retorna uma tabela de uma coluna que contém os valores distintos da coluna especificada. Valores duplicados são removidos e apenas valores exclusivos são retornados. Um valor BLANK pode ser adicionado. Quando o parâmetro de entrada é um nome de tabela, retorna as linhas da tabela especificada. As linhas duplicadas são preservadas. Uma linha BLANK pode ser adicionada.

Nota

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

Sintaxe

VALUES(<TableNameOrColumnName>)  

Parâmetros

Termo Definição
TableName ou ColumnName Uma coluna da qual valores exclusivos devem ser retornados ou uma tabela da qual linhas devem ser retornadas.

Valor devolvido

Quando o parâmetro de entrada é um nome de coluna, uma tabela de coluna única. Quando o parâmetro de entrada é um nome de tabela, uma tabela com as mesmas colunas é retornada.

Observações

  • Quando você usa a função VALUES em um contexto que foi filtrado, 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 nas regiões permitidas pelo filtro. Para retornar todas as cidades, independentemente dos filtros existentes, você deve usar a função ALL para remover filtros da tabela. O segundo exemplo demonstra o uso de ALL com VALUES.

  • Esta função não é suportada para utilização no modo DirectQuery quando utilizada em colunas calculadas ou regras de segurança ao nível da linha (RLS).

  • Para obter as práticas recomendadas ao usar VALUES, consulte Usar SELECTEDVALUE em vez de VALUES.

Na maioria dos cenários, quando o argumento é um nome de coluna, 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 valores possíveis na coluna especificada. No entanto, a função VALUES também pode retornar um valor em branco. Esse valor em branco é útil nos casos em que você está procurando valores distintos de uma tabela relacionada, mas um valor usado na relação está faltando em uma tabela. Na terminologia do banco de dados, isso é denominado uma violação da integridade referencial. Essas incompatibilidades nos dados podem ocorrer quando uma tabela está sendo atualizada e a tabela relacionada não.

Quando o argumento é um nome de tabela, o resultado da função VALUES retorna todas as linhas na tabela especificada mais uma linha em branco, se houver uma violação da integridade referencial. A função DISTINCT remove linhas duplicadas e retorna linhas exclusivas na tabela especificada.

Nota

A função DISTINCT permite que um nome de coluna ou qualquer expressão de tabela válida seja seu argumento, mas a função VALUES só aceita um nome de coluna ou um nome de tabela como argumento.

A tabela a seguir resume a incompatibilidade entre dados que pode 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
(não foram introduzidas datas de encomenda) Vendas de 3 de junho

Se você usar a função DISTINCT para retornar uma lista de datas, apenas duas datas serão retornadas. No entanto, 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á "correspondida" a este membro desconhecido.

Exemplo

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

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

Devoluções

Rótulos de linha Contar faturas
Accessories 18,208
Bikes 15,205
Vestuário 7,461
Total Geral 27,659

Função FILTRO
Função COUNTROWS
Funções de filtro