Ler em inglês

Compartilhar via


VALUES

aplica-se a:coluna calculadatabela calculadaMeasurecálculo visual

Quando o parâmetro de entrada é um nome de coluna, retorna uma tabela de uma coluna que contains o values distinto da coluna especificada. As values duplicadas são removidas and apenas values exclusivas são retornadas. Um BLANKvalue 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 values em uma célula or 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 values distintos que podem ser contados or usados para filterorsum outros values.

Sintaxe

DAX
VALUES(<TableNameOrColumnName>)  

Parâmetros

Termo Definição
TableName or ColumnName Uma coluna da qual values exclusivas devem ser retornadas, or uma tabela da qual as linhas devem ser retornadas.

Retornar value

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 values exclusivos retornados por VALUES são afetados pelo filter. Por exemplo, if você filter por Região, and retornar uma lista do values para Cidade, a lista incluirá apenas as cidades nas regiões permitidas pelo filter. Para retornar all das cidades, independentemente dos filtersexistentes, você deve usar a função ALL para remover filters da tabela. O exemplo de second demonstra o uso de ALL com VALUES.

  • Essa função not tem suporte para uso no modo DirectQuery quando usada em colunas calculadas or 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 and retornam uma lista dos possíveis values na coluna especificada. No entanto, a função VALUES também pode retornar um blankvalue. Esse blankvalue é útil em casos em que você está procurando values distintos de uma tabela related, mas uma value usada 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 and a tabela related é not.

Quando o argumento é um nome de tabela, o resultado da função VALUES retorna all linhas na tabela especificada mais uma linha blank, if há uma violação da integridade referencial. A função DISTINCT remove linhas duplicadas and retorna linhas exclusivas na tabela especificada.

Observação

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

A tabela a seguir resume a incompatibilidade entre os dados que podem ocorrer em duas tabelas related quando a integridade referencial é not 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

If você usar a função DISTINCT para retornar uma lista de datas, apenas duas datas serão retornadas. No entanto, if você usar a função VALUES, a função retorna as duas datas mais um membro blank adicional. Além disso, qualquer linha da tabela MySales que not tiver uma date correspondente na tabela MyOrders será "correspondida" a esse membro desconhecido.

Exemplo

A fórmula a seguir conta o número de faturas exclusivas (pedidos de venda), and produz os seguintes resultados quando usada em um relatório que inclui os nomes de categoria de Product:

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

Retorna

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

de função
de função
Filter funções