Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Fonction COUNT dans Amazon QLDB
<a name="ql-functions.count"></a>

**Important**  
Avis de fin de support : les clients existants pourront utiliser Amazon QLDB jusqu'à la fin du support le 31 juillet 2025. Pour plus de détails, consultez [Migrer un registre Amazon QLDB vers Amazon Aurora PostgreSQL](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/).

Dans Amazon QLDB, utilisez `COUNT` la fonction pour renvoyer le nombre de documents définis par l'expression donnée. Cette fonction comporte deux variantes :
+ `COUNT(*)`— Compte tous les documents de la table cible, qu'ils incluent ou non des valeurs nulles ou manquantes.
+ `COUNT(expression)`— Calcule le nombre de documents contenant des valeurs non nulles dans un champ ou une expression spécifique et existant.

**Avertissement**  
La `COUNT` fonction n'étant pas optimisée, nous vous déconseillons de l'utiliser sans recherche indexée. Lorsque vous exécutez une requête dans QLDB sans recherche indexée, une analyse complète de la table est déclenchée. Cela peut entraîner des problèmes de performances sur de grandes tables, notamment des conflits de simultanéité et des délais d'expiration des transactions.  
Pour éviter de scanner des tables, vous devez exécuter des instructions contenant une clause de `WHERE` prédicat à l'aide d'un opérateur d'*égalité* (`=`ou`IN`) sur un champ indexé ou un identifiant de document. Pour de plus amples informations, veuillez consulter [Optimisation des performances des requêtes](working.optimize.md).

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

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

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

*expression*  
Nom du champ ou expression sur lequel la fonction agit. Ce paramètre peut être n'importe lequel des paramètres pris en charge[Types de données](ql-reference.data-types.md).

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

`int`

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

## Fonctions associées
<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)