Ler em inglês

Partilhar 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. Os values duplicados são removidos and apenas values exclusivos são retornados. Uma BLANKvalue pode ser adicionada. 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 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

VALUES(<TableNameOrColumnName>)  

Parâmetros

Termo Definição
TableName or ColumnName Uma coluna da qual values exclusivos devem ser retornados or uma tabela a partir da qual as linhas devem ser retornadas.

Regresso value

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

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

Nota

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 só aceita um nome de coluna or um nome de tabela como argumento.

A tabela a seguir resume a incompatibilidade entre dados que pode 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
(não foram introduzidas datas de encomenda) 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 tenha um date correspondente na tabela MyOrders será "correspondida" a esse membro desconhecido.

Exemplo

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

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

Devoluções

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

FILTER função
COUNTROWS função
Filter funções