$limit - Amazon DocumentDB
Esempio (MongoDB Shell)Esempi di codice

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à.

$limit

L'$limitoperatore in Amazon DocumentDB viene utilizzato per limitare il numero di documenti restituiti da una query. È simile all'operatore $limit MongoDB, ma ci sono alcune considerazioni specifiche quando lo si utilizza con Amazon DocumentDB.

In Amazon DocumentDB, l'$limitoperatore è utile per l'impaginazione, in cui si desidera recuperare un sottoinsieme del totale dei documenti corrispondenti. Consente di controllare il numero di documenti restituiti in ogni risposta, migliorando le prestazioni e riducendo la quantità di dati trasferiti sulla rete.

Parametri

  • limit: Il numero massimo di documenti da restituire. Deve essere un valore intero non negativo.

Esempio (MongoDB Shell)

L'esempio seguente mostra come utilizzare l'$limitoperatore per restituire al massimo un documento che corrisponde al filtro specificato.

Crea documenti di esempio

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

Esempio di interrogazione

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

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

Output

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

Esempi di codice

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

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()