Compartilhar via

VALUES

  • Artigo

aplica-se a:coluna calculadatabela calculadamedidacá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. Linhas duplicadas são preservadas. Uma linha BLANK pode ser adicionada.

Observação

Essa 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 os valores exclusivos devem ser retornados ou uma tabela da qual as linhas devem ser retornadas.

Valor de retorno

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

Comentários

  • 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.

  • 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).

  • Para obter 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á ausente de uma tabela. Na terminologia do banco de dados, isso é chamado de violação de integridade referencial. Essas incompatibilidades nos dados podem ocorrer quando uma tabela está sendo atualizada e a tabela relacionada não está.

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.

Observação

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 aceita apenas um nome de coluna ou um nome de tabela como o argumento.

A tabela a seguir resume a incompatibilidade entre os 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ê 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 (pedidos de vendas) e produz os seguintes resultados quando usada em um relatório que inclui os Nomes de Categoria de Produto:

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

Retorna

Rótulos de linha Contar faturas
Acessórios 18.208
Bicicletas 15.205
Vestuário 7\.461
Total Geral 27.659

Conteúdo relacionado

função FILTERCOUNTROWS funçãoFiltrar funções