Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Función COUNT en Amazon QLDB
<a name="ql-functions.count"></a>

**importante**  
Aviso de fin del soporte: los clientes actuales podrán utilizar Amazon QLDB hasta que finalice el soporte, el 31 de julio de 2025. Para obtener más información, consulte [Migración de un registro de Amazon QLDB a Amazon Aurora](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/) PostgreSQL.

En Amazon QLDB, use la función `COUNT` para devolver el número de documentos definidos por la expresión dada. Esta función tiene dos variaciones:
+ `COUNT(*)`: cuenta todos los documentos de la tabla de destino, incluyan o no valores nulos o faltantes.
+ `COUNT(expression)`: calcula el número de documentos con valores no nulos en un campo o expresión existente específico.

**aviso**  
La función `COUNT` no está optimizada, por lo que no recomendamos usarla sin una búsqueda indexada. Cuando ejecuta una consulta en QLDB sin una búsqueda indexada, se invoca un escaneo completo de la tabla. Esto puede provocar problemas de rendimiento en tablas grandes, como conflictos de concurrencia y tiempos de espera de las transacciones.  
Para evitar el escaneado de tablas, debe ejecutar las instrucciones con una cláusula de predicado `WHERE` usando un operador de *igualdad* (`=` o `IN`) en un campo indexado o en un ID de documento. Para obtener más información, consulte [Optimización del rendimiento de las consultas](working.optimize.md).

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

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

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

*expression*  
El nombre de campo o la expresión sobre la que opera la función. Este parámetro puede ser cualquiera de los [Tipos de datos](ql-reference.data-types.md) compatibles.

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

`int`

## Ejemplos
<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
```

## Funciones 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)