Pular para o conteúdo principal
Página traduzida

Esta página foi traduzida do inglês com assistência de IA. Se houver diferenças entre as duas, a versão em inglês é a referência.

COUNT

Retorna o número total de registros de um recurso ou a contagem das instâncias não NULL de uma coluna em um agrupamento.

Veja também:
[SELECT]


Sintaxe​

SELECT COUNT( * | columnExpression ) FROM <multipartIdentifier>
[ GROUP BY groupByColumn ];

Argumentos​

columnExpression ou *
Uma coluna ou expressão. Se * for especificado, a função conta todos os registros do recurso ou do agrupamento.

Os valores NULL de columnExpression não são contados. Se todos os valores forem NULL, COUNT retorna 0.

groupByColumn
Uma ou mais colunas usadas para realizar operações de resumo ou de agregação. A cláusula GROUP BY retorna uma linha para cada agrupamento de colunas.

Valor(es) retornado(s)​

Retorna um inteiro que representa a contagem.


Exemplos​

Retornar o número de linhas de todo um recurso​

SELECT count(*) as num_instances
FROM google.compute.instances
WHERE project = 'stackql-demo'
AND zone = 'australia-southeast1-a';

Retornar o número de linhas agrupadas por uma expressão de coluna​

SELECT SPLIT_PART(machineType, '/', -1) as machine_type, count(*) as num_instances
FROM google.compute.instances
WHERE project = 'stackql-demo'
AND zone = 'australia-southeast1-a'
GROUP BY SPLIT_PART(machineType, '/', -1);

Usar COUNT como função de janela para calcular contagens cumulativas​

-- Track cumulative issue counts over time
SELECT
number,
title,
state,
created_at,
COUNT(*) OVER (ORDER BY created_at) as cumulative_issues,
COUNT(*) OVER (PARTITION BY state ORDER BY created_at) as cumulative_by_state
FROM github.issues.issues
WHERE owner = 'stackql'
AND repo = 'stackql'
ORDER BY created_at;

Para obter mais informações, consulte https://www.sqlite.org/lang_aggfunc.html#count.