> ## Documentation Index
> Fetch the complete documentation index at: https://villagesql.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# COUNT DISTINCT no MySQL

> Como COUNT(DISTINCT coluna) conta valores diferentes em vez de linhas no MySQL, como contar combinações distintas, e por que ele ignora NULL por completo.

> [card] [VillageSQL is a drop-in replacement for MySQL with extensions.](https://villagesql.com/docs/en/8.4/stable/install-server.md)
>
> All examples on this page work on VillageSQL. Install Now →

`COUNT(*)` responde quantas linhas. `COUNT(DISTINCT column)` responde quantos
valores diferentes, que normalmente é a pergunta mais interessante sobre uma coluna
que você ainda não conhece.

Abra o cliente com `mysql -u root -p sakila` antes de começar.

## Como COUNT DISTINCT funciona

```sql theme={null}
SELECT COUNT(DISTINCT COLUMN_NAME)
FROM TABLE_NAME;
```

Substitua `COLUMN_NAME` pela coluna cujos valores diferentes você quer contar,
e `TABLE_NAME` pela tabela. O servidor lê todas as linhas, descarta as
repetições, e conta o que sobra.

É a contagem do que [SELECT DISTINCT](https://villagesql.com/docs/pt-BR/tutorial/select-distinct.md)
retornaria, sem retorná-lo.

## Exemplos

### Quantos valores diferentes

```sql theme={null}
SELECT COUNT(*) AS rows_total, COUNT(DISTINCT rating) AS ratings FROM film;
```

```text theme={null}
+------------+---------+
| rows_total | ratings |
+------------+---------+
|       1000 |       5 |
+------------+---------+
1 row in set (0.01 sec)
```

1.000 filmes distribuídos em 5 classificações.

### Combinações diferentes

Nomeie várias colunas e uma combinação conta uma vez, da mesma forma que o `GROUP BY`
as trata.

```sql theme={null}
SELECT COUNT(DISTINCT rating, rental_rate) AS combinations FROM film;
```

```text theme={null}
+--------------+
| combinations |
+--------------+
|           15 |
+--------------+
1 row in set (0.00 sec)
```

5 classificações vezes 3 tarifas, e toda combinação ocorre. Uma linha em que qualquer uma das
colunas nomeadas é NULL não é contada de jeito nenhum.

## Ele ignora NULL, o que pode fazer a resposta parecer errada

`address2` é NULL em 4 linhas e uma string vazia nas outras 599.

```sql theme={null}
SELECT COUNT(*) AS rows_total,
       COUNT(DISTINCT address2) AS distinct_values
FROM address;
```

```text theme={null}
+------------+-----------------+
| rows_total | distinct_values |
+------------+-----------------+
|        603 |               1 |
+------------+-----------------+
1 row in set (0.00 sec)
```

A resposta é 1. A string vazia é 1 valor distinto, e os NULLs são
ignorados em vez de contados como um valor próprio. Então "quantas coisas diferentes há
nesta coluna" não é o que a função responde quando algumas linhas estão vazias: ela
responde "quantos valores diferentes", e NULL é a ausência de um.

Quando você precisa dos dois números, conte as linhas ausentes com uma segunda consulta:
`SELECT COUNT(*) FROM address WHERE address2 IS NULL`.

## Resumo

* Use `COUNT(DISTINCT column)` para contar valores diferentes em vez de linhas.
* Nomeie várias colunas para contar combinações distintas.
* Espere que NULL seja ignorado, e não contado como um valor.
* Conte as linhas ausentes separadamente quando precisar dos dois números.

## Veja também

* [Funções de agregação](https://villagesql.com/docs/pt-BR/tutorial/aggregate-functions.md) — o resto da família
* [SELECT DISTINCT](https://villagesql.com/docs/pt-BR/tutorial/select-distinct.md) — retornando esses valores em vez de contá-los
* [GROUP BY](https://villagesql.com/docs/pt-BR/tutorial/group-by.md) — contando por categoria
* [Desempenho de GROUP BY no MySQL](https://villagesql.com/docs/pt-BR/guides/group-by-having.md) — o que desduplicar custa em escala


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.