Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# $count (fase)
<a name="count"></a>

La fase di `$count` aggregazione in Amazon DocumentDB viene utilizzata per contare il numero di documenti che passano alla fase. Viene spesso utilizzata come fase finale di una pipeline di aggregazione per restituire il numero totale di documenti corrispondenti alle fasi precedenti.

**Parametri**
+ `field`: Il campo da contare. Questo parametro è facoltativo e, se non fornito, lo stage conterà il numero totale di documenti di input.

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

L'esempio seguente dimostra come utilizzare lo `$count` stage per ottenere il numero totale di documenti in una raccolta.

**Crea documenti di esempio **

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

**Esempio di interrogazione **

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

**Output**

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

L'esempio aggrega la `users` raccolta e utilizza la `$count` fase per contare il numero totale di documenti.

## Esempi di codice
<a name="count-code"></a>

Per visualizzare un esempio di codice per l'utilizzo del `$count` comando, scegliete la scheda corrispondente alla lingua che desiderate utilizzare:

------
#### [ 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()
```

------