DISTINCT (coluna)

  • Artigo

Aplica-se a:Coluna calculadaTabela calculadaMedidaCálculo visual

Retorna uma tabela de coluna única 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 em uma célula ou coluna em uma planilha; em vez disso, você aninha a função DISTINCT dentro de uma fórmula para obter uma lista de valores distintos que podem ser passados para outra função e, em seguida, contados, somados ou usados para outras operações.

Sintaxe

DISTINCT(<column>)

Parâmetros

Termo Definição
coluna A coluna da qual os valores exclusivos serão retornados. Ou uma expressão que retorna uma coluna.

Valor retornado

Uma coluna de valores exclusivos.

Comentários

  • Os resultados de DISTINCT são afetados pelo contexto do filtro atual. Por exemplo, se você usar a fórmula no exemplo a seguir para criar uma medida, os resultados serão alterados sempre que a tabela for filtrada para mostrar apenas uma região ou um período específico.

  • Não há suporte para a função ser usada no modo DirectQuery quando usada em regras RLS (segurança em nível de linha) ou colunas calculadas.

Há outra versão da função DISTINCT, DISTINCT(table), que retorna uma tabela removendo linhas duplicadas de outra tabela ou expressão.

A função VALUES é semelhante a DISTINCT; ela também pode ser usada para retornar uma lista de valores exclusivos e geralmente retornará exatamente os mesmos resultados que DISTINCT. No entanto, em alguns contextos, VALUES retornará um valor especial adicional. Para obter mais informações, confira a função VALUES.

Exemplo

A fórmula a seguir conta o número de clientes exclusivos que geraram pedidos no canal da Internet. A tabela a seguir ilustra os possíveis resultados quando a fórmula é adicionada a um relatório.

= COUNTROWS(DISTINCT(InternetSales_USD[CustomerKey]))

Não é possível colar a lista de valores que DISTINCT retorna diretamente para uma coluna. Em vez disso, você passa os resultados da função DISTINCT para outra função que conta, filtra ou agrega valores usando a lista. Para tornar o exemplo o mais simples possível, aqui a tabela de valores distintos foi passada para a função COUNTROWS.

Rótulos de linha Acessórios Bikes Clothing Grande Total
2005 1013 1013
2006 2677 2677
2007 6792 4875 2867 9309
2008 9435 5451 4196 11377
Total Geral 15114 9132 6852 18484

Além disso, observe que os resultados não são aditivos. Isso significa que o número total de clientes exclusivos em 2007 não é a soma de clientes exclusivos de Acessórios, Bicicletas e Roupas para aquele ano. O motivo é que um cliente pode ser contado em vários grupos.

Conteúdo relacionado

Funções de filtro
Função FILTER
função RELATED
Função VALUES