APPROXIMATEDISTINCTCOUNT

Aplica-se a:Coluna calculadaTabela calculadaMedidaCálculo visual

Devolve uma contagem de estimada de valores únicos numa coluna.

Importante

O suporte para APPROXIMATEDISTINCTCOUNT os modos de armazenamento Import e Direct Lake está atualmente em pré-visualização.

Sintaxe

APPROXIMATEDISTINCTCOUNT(<columnName>)

Parâmetros

Vigência Descrição
column Coluna de entrada.

O column argumento não pode ser uma expressão.

Valor de retorno

O número aproximado de valores distintos em column.

Comentários

  • O único argumento para esta função é uma coluna. Use colunas que contenham qualquer tipo de dados. Quando a função não encontra linhas para contar, devolve um BLANK; caso contrário, devolve a contagem de valores distintos.

  • No modo Importação, Direct Lake no OneLake e Direct Lake em SQL sem recurso B, a função utiliza um algoritmo HyperLogLog do lado do motor.

  • No modo DirectQuery, a função invoca uma operação de agregação correspondente na fonte de dados. Este comportamento é suportado para SQL do Azure, Azure Synapse dedicado SQL pool, BigQuery, Databricks e Snowflake. O Direct Lake no SQL utiliza este comportamento DirectQuery quando volta ao modo DirectQuery.

  • Use esta função para colunas de alta cardinalidade quando um resultado aproximado é aceitável. Use DISTINCTCOUNT quando precisar de um resultado exato.

  • Para colunas de baixa cardinalidade, APPROXIMATEDISTINCTCOUNT pode ter um desempenho mais lento do que DISTINCTCOUNT. Também pode usar mais memória do que DISTINCTCOUNT, especialmente em modelos grandes, alta concorrência ou muitos grupos agrupados.

  • A contagem estimada devolvida por APPROXIMATEDISTINCTCOUNT tem uma taxa de erro de aproximadamente 1,6% para os modelos Import e Direct Lake.