As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Função COUNT no Amazon QLDB
<a name="ql-functions.count"></a>

**Importante**  
Aviso de fim do suporte: os clientes existentes poderão usar o Amazon QLDB até o final do suporte em 31/07/2025. Para obter mais detalhes, consulte [Migrar um Amazon QLDB Ledger para o Amazon](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/) Aurora PostgreSQL.

No Amazon QLDB, use a função `COUNT` para retornar o número de documentos que são definidos pela expressão dada. A função tem duas variações:
+ `COUNT(*)`: conta todos os documentos na tabela de destino, independentemente de incluírem ou não valores nulos ou ausentes.
+ `COUNT(expression)`: calcula o número de documentos com valores não nulos em um campo ou expressão específica existente.

**Atenção**  
A função `COUNT` não está otimizada, portanto, não recomendamos usá-la sem uma pesquisa indexada. Quando você executa uma consulta no QLDB sem uma pesquisa indexada, ela invoca uma verificação completa da tabela. Isso pode causar problemas de desempenho em tabelas grandes, incluindo conflitos de simultaneidade e tempos limite de transação.  
Para evitar verificações de tabelas, você deve executar instruções com uma cláusula de predicado `WHERE` usando um operador de *igualdade* (`=` ou `IN`) em um campo indexado ou em um ID de documento. Para obter mais informações, consulte [Otimizar a performance da consulta](working.optimize.md).

## Sintaxe
<a name="ql-functions.count.syntax"></a>

```
COUNT ( * | expression )
```

## Argumentos
<a name="ql-functions.count.arguments"></a>

*expression*  
O nome do campo ou expressão na qual a função opera. Esse parâmetro pode ser qualquer um dos [Tipos de dados](ql-reference.data-types.md) com suporte.

## Tipo de retorno
<a name="ql-functions.count.return-type"></a>

`int`

## Exemplos
<a name="ql-functions.count.examples"></a>

```
SELECT COUNT(*) FROM VehicleRegistration r WHERE r.LicensePlateNumber = 'CA762X' -- 1
SELECT COUNT(r.VIN) FROM Vehicle r WHERE r.VIN = '1N4AL11D75C109151'             -- 1
SELECT COUNT(a) FROM << { 'a' : 1 }, { 'a': 2 }, { 'a': 3 } >>                   -- 3
```

## Funções relacionadas
<a name="ql-functions.count.related"></a>
+ [AVG](ql-functions.avg.md)
+ [MAX](ql-functions.max.md)
+ [MIN](ql-functions.min.md)
+ [SIZE](ql-functions.size.md)
+ [SUM](ql-functions.sum.md)