# COUNT

> Função de agregação COUNT no StackQL: o número de linhas de um recurso ou de valores não NULL de uma coluna em um agrupamento.

Source: https://stackql.io/pt-br/language-spec/functions/aggregate/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 `]](/language-spec/select)

* * * 

## Sintaxe

```sql
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.

> Pelo menos um valor de *columnExpression* deve ser não `NULL`; caso contrário, a função retorna `NULL`.

__*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

```sql
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

```sql
SELECT tags, count(*) as num_instances
FROM google.compute.instances 
WHERE project = 'stackql-demo' 
AND zone = 'australia-southeast1-a'
GROUP BY json_extract(tags, '$.instanceType');
```

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

```sql
-- 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](https://www.sqlite.org/lang_aggfunc.html#count).
