APPROXIMATEDISTINCTCOUNT

aplica-se a:coluna calculadatabela calculadamedidacálculo visual

Retorna uma contagem estimada de valores exclusivos em uma coluna.

Importante

O suporte para APPROXIMATEDISTINCTCOUNT os modos de armazenamento Importação e Direct Lake está atualmente em versão prévia.

Sintaxe

APPROXIMATEDISTINCTCOUNT(<columnName>)

Parâmetros

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

Observações

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

• No modo De importação, Direct Lake no OneLake e Direct Lake no SQL sem fallback, a função usa um algoritmo HyperLogLog do lado do mecanismo.

• No modo DirectQuery, a função invoca uma operação de agregação correspondente na fonte de dados. Esse comportamento tem suporte para SQL do Azure, Azure Synapse pool de SQL dedicado, BigQuery, Databricks e Snowflake. O Direct Lake no SQL usa esse comportamento do DirectQuery quando ele volta para o modo DirectQuery.

• Use essa função para colunas de alta cardinalidade quando um resultado aproximado for aceitável. Use DISTINCTCOUNT quando você precisar de um resultado exato.

• Para colunas de baixa cardinalidade, APPROXIMATEDISTINCTCOUNT pode ter um desempenho mais lento do que DISTINCTCOUNT. Ele também pode usar mais memória do que DISTINCTCOUNT, especialmente com modelos grandes, alta simultaneidade ou muitos grupos agrupados.

• A contagem estimada retornada tem APPROXIMATEDISTINCTCOUNT uma taxa de erro de aproximadamente 1,6% para modelos de Importação e Direct Lake.