Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

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

`$limit`Operator di Amazon DocumentDB digunakan untuk membatasi jumlah dokumen yang dikembalikan oleh kueri. Ini mirip dengan operator `$limit` MongoDB, tetapi ada beberapa pertimbangan khusus saat menggunakannya dengan Amazon DocumentDB.

Di Amazon DocumentDB, `$limit` operator berguna untuk pagination, di mana Anda ingin mengambil subset dari total dokumen yang cocok. Ini memungkinkan Anda untuk mengontrol jumlah dokumen yang dikembalikan dalam setiap respons, meningkatkan kinerja dan mengurangi jumlah data yang ditransfer melalui jaringan.

**Parameter**
+ `limit`: Jumlah maksimum dokumen untuk dikembalikan. Ini harus berupa nilai integer non-negatif.

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

Contoh berikut menunjukkan cara menggunakan `$limit` operator untuk mengembalikan maksimal satu dokumen yang cocok dengan filter yang diberikan.

**Buat dokumen sampel**

```
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" }
]);
```

**Contoh kueri**

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

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

**Keluaran**

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

## Contoh kode
<a name="limit-code"></a>

Untuk melihat contoh kode untuk menggunakan `$limit` perintah, pilih tab untuk bahasa yang ingin Anda gunakan:

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

------