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.

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

Der `$limit` Operator in Amazon DocumentDB wird verwendet, um die Anzahl der von einer Abfrage zurückgegebenen Dokumente einzuschränken. Er ähnelt dem `$limit` MongoDB-Operator, es gibt jedoch einige spezifische Überlegungen, wenn er mit Amazon DocumentDB verwendet wird.

In Amazon DocumentDB ist der `$limit` Operator nützlich für die Paginierung, bei der Sie eine Teilmenge der gesamten übereinstimmenden Dokumente abrufen möchten. Damit können Sie die Anzahl der Dokumente kontrollieren, die in jeder Antwort zurückgesendet werden, wodurch die Leistung verbessert und die Menge der über das Netzwerk übertragenen Daten reduziert wird.

**Parameter**
+ `limit`: Die maximale Anzahl von Dokumenten, die zurückgegeben werden sollen. Dies muss ein nicht negativer Ganzzahlwert sein.

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

Das folgende Beispiel zeigt, wie der `$limit` Operator verwendet wird, um maximal ein Dokument zurückzugeben, das dem angegebenen Filter entspricht.

**Erstellen Sie Beispieldokumente**

```
db.test.insertMany([
  { "_id": 1, "star_rating": 4, "comments": "apple is red" },
  { "_id": 2, "star_rating": 5, "comments": "comfortable couch" },
  { "_id": 3, "star_rating": 3, "comments": "apples, oranges - healthy fruit" },
  { "_id": 4, "star_rating": 5, "comments": "this is a great couch" },
  { "_id": 5, "star_rating": 5, "comments": "interesting couch" }
]);
```

**Beispiel für eine Abfrage**

```
db.test.createIndex({ comments: "text" });

db.test.find({
  $and: [
    { star_rating: 5 },
    { $text: { $search: "couch" } }
  ]
}).limit(1);
```

**Ausgabe**

```
[ { _id: 2, star_rating: 5, comments: 'comfortable couch' } ]
```

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

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

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

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

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

  try {
      await client.connect();
      
      const db = client.db('test');
      const collection = db.collection('test');

      await collection.createIndex({ comments: 'text' });

      const query = {
        $and: [
          { star_rating: 5 },
          { $text: { $search: "couch" } }
        ]
      };

      const result = await collection.find(query).limit(1).toArray();

      console.log(result);

    } catch (err) {
        console.error("Error:", err);
    } finally {
        await client.close();
    }

}

limitExample();
```

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

```
from pymongo import MongoClient

def limit_example():
    try:
        client = MongoClient('mongodb://<username>:<password>@<cluster-endpoint>:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false')

        db = client['test']
        collection = db['test']

        collection.create_index([('comments', 'text')])

        query = {
            '$and': [
                {'star_rating': 5},
                {'$text': {'$search': 'couch'}}
            ]
        }

        result = collection.find(query).limit(1)

        for doc in result:
            print(doc)

    except Exception as e:
        print(f"An error occurred: {e}")
    
    finally:
        client.close()

limit_example()
```

------