Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

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

Die `$count` Aggregationsphase in Amazon DocumentDB wird verwendet, um die Anzahl der Dokumente zu zählen, die in die Phase gelangen. Sie wird häufig als letzte Phase in einer Aggregationspipeline verwendet, um die Gesamtzahl der Dokumente zurückzugeben, die den vorherigen Phasen entsprechen.

**Parameter**
+ `field`: Das zu zählende Feld. Dieser Parameter ist optional. Wenn er nicht angegeben wird, zählt die Phase die Gesamtzahl der Eingabedokumente.

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

Das folgende Beispiel zeigt, wie der `$count` Schritt verwendet wird, um die Gesamtzahl der Dokumente in einer Sammlung abzurufen.

**Erstellen Sie Beispieldokumente**

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

**Beispiel für eine Abfrage**

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

**Ausgabe**

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

Das Beispiel aggregiert die `users` Sammlung und verwendet die `$count` Phase, um die Gesamtzahl der Dokumente zu zählen.

## Codebeispiele
<a name="count-code"></a>

Um ein Codebeispiel für die Verwendung des `$count` Befehls anzuzeigen, wählen Sie die Registerkarte für die Sprache, die Sie verwenden möchten:

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

------