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.

# \$1count
<a name="count"></a>

La phase d'`$count`agrégation dans Amazon DocumentDB est utilisée pour compter le nombre de documents qui passent dans la phase. Il est souvent utilisé comme dernière étape d'un pipeline d'agrégation pour renvoyer le nombre total de documents correspondant aux étapes précédentes.

**Paramètres**
+ `field`: Le champ à compter. Ce paramètre est facultatif, et s'il n'est pas fourni, l'étape comptabilisera le nombre total de documents d'entrée.

## Exemple (MongoDB Shell)
<a name="count-examples"></a>

L'exemple suivant montre comment utiliser le `$count` stage pour obtenir le nombre total de documents d'une collection.

**Création d'exemples de documents**

```
db.users.insertMany([
  { name: "John", age: 30 },
  { name: "Jane", age: 25 },
  { name: "Bob", age: 35 },
  { name: "Alice", age: 28 }
]);
```

**Exemple de requête**

```
db.users.aggregate([
  { $count: "total" }
]);
```

**Sortie**

```
{ "total" : 4 }
```

L'exemple agrège la `users` collection et utilise l'`$count`étape pour compter le nombre total de documents.

## Exemples de code
<a name="count-code"></a>

Pour afficher un exemple de code d'utilisation de la `$count` commande, choisissez l'onglet correspondant à la langue que vous souhaitez utiliser :

------
#### [ Node.js ]

```
const { MongoClient } = require('mongodb');

async function countDocuments() {
  const client = await MongoClient.connect('mongodb://<username>:<password>@<cluster-endpoint>:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false');
  const db = client.db('mydb');
  const collection = db.collection('users');

  const result = await collection.aggregate([
    { $count: "total" }
  ]).toArray();

  console.log(result[0].total);

  await client.close();
}

countDocuments();
```

------
#### [ Python ]

```
from pymongo import MongoClient

def count_documents():
    client = MongoClient('mongodb://<username>:<password>@<cluster-endpoint>:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false')
    db = client['mydb']
    collection = db['users']

    result = list(collection.aggregate([
        { '$count': "total" }
    ]))

    print(result[0]['total'])

    client.close()

count_documents()
```

------