MongoDB: метод cursor.limit ()

cursor.limit

Метод cursor.limit () используется для указания максимального количества документов, которые будет возвращать курсор.

Синтаксис:

 cursor.limit ()

ПРИМЕЧАНИЕ. Вы должны применить limit () к курсору перед извлечением любых документов из базы данных.

Используйте limit (), чтобы максимизировать производительность и не дать MongoDB возвращать больше результатов, чем требуется для обработки.

Образец документа в коллекции ресторанов:

{
  "address": {
     "building": "1007",
     "coord": [ -73.856077, 40.848447 ],
     "street": "Morris Park Ave",
     "zipcode": "10462"
  },
  "borough": "Bronx",
  "cuisine": "Bakery",
  "grades": [
     { "date": { "$date": 1393804800000 }, "grade": "A", "score": 2 },
     { "date": { "$date": 1378857600000 }, "grade": "A", "score": 6 },
     { "date": { "$date": 1358985600000 }, "grade": "A", "score": 10 },
     { "date": { "$date": 1322006400000 }, "grade": "A", "score": 9 },
     { "date": { "$date": 1299715200000 }, "grade": "B", "score": 14 }
  ],
  "name": "Morris Park Bake Shop",
  "restaurant_id": "30075445"
}
.......

Пример: MongoDB: cursor.limit () метод

Следующий пример ограничит возврат документов в пределах 10 из коллекционных ресторанов.

db.restaurants.find({"cuisine" : "American "}).limit(10);

Получить данные о ресторанах здесь

Выход:

 > db.restaurants.find ({"kitchen": "American"}). limit (10);
{"_id": ObjectId ("55c3043ab165fa6355ec5c8c"), "address": {"building": "2780", "ord": [-73.98241999999999, 40.579505], "street": "Stillwell Avenue", "почтовый индекс": " 11224 "}," borough ":" Brooklyn "," kitchen ":" American "," grades ": [{" date ": ISODate (" 2014-06-10T00: 00: 00Z ")," grade ":"
"," оценка ": 5}, {" дата ": ISODate (" 2013-06-05T00: 00: 00Z ")," оценка ":" А "," оценка ": 7}, {" дата ": ISODate ("2012-04-13T00: 00: 00Z"), "оценка": "A", "оценка": 12}, {"дата": ISODate ("2011-10-12T00: 00: 00Z"), " оценка ":" А "," оценка ": 12}]," имя ":" Поставщик ривьеры "," идентификатор ресторана ":" 40356018 "
 }
{"_id": ObjectId ("55c3043ab165fa6355ec5c8e"), "address": {"building": "8825", "corre": [-73.8803827, 40.7643124], "street": "Бульвар Астории", "почтовый индекс": " 11369 "}," местный ":" Королевы "," кухня ":" американская "," классы ": [{" date ": ISODate (" 2014-11-15T00: 00: 00Z ")," grade ":" Z "," sco
re ": 38}, {" дата ": ISODate (" 2014-05-02T00: 00: 00Z ")," оценка ":" A "," оценка ": 10}, {" дата ": ISODate (" 2013 -03-02T00: 00: 00Z ")," оценка ":" A "," оценка ": 7}, {" дата ": ISODate (" 2012-02-10T00: 00: 00Z ")," оценка ": «А», «оценка»: 13}], «имя»: «Брунос на бульваре», «restaurant_id»: «4035615
1 "}
{"_id": ObjectId ("55c3043ab165fa6355ec5c91"), "address": {"building": "6409", "ordin ": [-74.00528899999999, 40.628886]," улица ":" 11 Avenue "," почтовый индекс ":" 11219 "}," городской округ ":" Бруклин "," кухня ":" американская "," классы ": [{" дата ": ISODate (" 2014-07-18T00: 00: 00Z ")," класс ":" "," Sco
re ": 12}, {" дата ": ISODate (" 2013-07-30T00: 00: 00Z ")," оценка ":" A "," оценка ": 12}, {" дата ": ISODate (" 2013 -02-13T00: 00: 00Z ")," оценка ":" A "," оценка ": 11}, {" дата ": ISODate (" 2012-08-16T00: 00: 00Z ")," оценка ": «A», «оценка»: 2}, {«дата»: ISODate («2011-08-17T00: 00: 00Z»), «оценка»: «A», «scor»
e ": 11}]," name ":" Regina Caterers "," restaurant_id ":" 40356649 "}
{"_id": ObjectId ("55c3043ab165fa6355ec5c93"), "address": {"building": "2300", "corre": [-73.8786113, 40.8502883], "street": "Южный бульвар", "почтовый индекс": " 10460 "}," городской округ ":" Бронкс "," кухня ":" американская "," классы ": [{" дата ": ISODate (" 2014-05-28T00: 00: 00Z ")," класс ":" "," Sco
re ": 11}, {" date ": ISODate (" 2013-06-19T00: 00: 00Z ")," grade ":" A "," score ": 4}, {" date ": ISODate (" 2012 -06-15T00: 00: 00Z ")," grade ":" A "," score ": 3}]," name ":" Wild Asia "," restaurant_id ":" 40357217 "}
{"_id": ObjectId ("55c3043ab165fa6355ec5c94"), "address": {"building": "7715", "corre": [-73.9973325, 40.61174889999999], "street": "18 Avenue", "zipcode": " 11214 "}," городской округ ":" Бруклин "," кухня ":" американская "," классы ": [{" дата ": ISODate (" 2014-04-16T00: 00: 00Z ")," класс ":" A "," sc
руда ": 5}, {" дата ": ISODate (" 2013-04-23T00: 00: 00Z ")," оценка ":" A "," оценка ": 2}, {" дата ": ISODate (" 2012 -04-24T00: 00: 00Z ")," оценка ":" A "," оценка ": 5}, {" дата ": ISODate (" 2011-12-16T00: 00: 00Z ")," оценка ": "A", "score": 2}], "name": "C & C Catering Service", "restaurant_id": "40357437"
}
{"_id": ObjectId ("55c3043ab165fa6355ec5c96"), "address": {"building": "1", "corre": [-73.96926909999999, 40.7685235], "street": "East 66 Street", "zipcode": "10065"}, "городской округ": "Манхэттен", "кухня": "американская", "классы": [{"дата": ISODate ("2014-05-07T00: 00: 00Z"), "класс": «А»
, "оценка": 3}, {"дата": ISODate ("2013-05-03T00: 00: 00Z"), "оценка": "А", "оценка": 4}, {"дата": ISODate ( "2012-04-30T00: 00: 00Z"), "оценка": "A", "оценка": 6}, {"дата": ISODate ("2011-12-27T00: 00: 00Z"), "оценка ":" A "," score ": 0}]," name ":" 1 East 66Th Street Kitchen "," restaurant_id ":" 4
0359480 "}
{"_id": ObjectId ("55c3043ab165fa6355ec5c9b"), "address": {"building": "522", "corre": [-73.95171, 40.767461], "street": "East 74 Street", "zipcode": "10021"}, "местный": "Манхэттен", "кухня": "американская", "классы": [{"дата": ISODate ("2014-09-02T00: 00: 00Z"), "класс": "Оценка
": 12}, {" дата ": ISODate (" 2013-12-19T00: 00: 00Z ")," оценка ":" B "," оценка ": 16}, {" дата ": ISODate (" 2013- 05-28T00: 00: 00Z ")," оценка ":" A "," оценка ": 9}, {" дата ": ISODate (" 2012-12-07T00: 00: 00Z ")," оценка ":" А "," оценка ": 13}, {" дата ": ISODate (" 2012-03-29T00: 00: 00Z ")," оценка ":" А "," оценка "
 : 11}], "name": "Glorious Food", "restaurant_id": "40361521"}
{"_id": ObjectId ("55c3043ab165fa6355ec5c9c"), "address": {"building": "284", "corre": [-73.9829239, 40.6580753], "street": "Prospect Park West", "почтовый индекс": "11215"}, "городской округ": "Бруклин", "кухня": "американская", "классы": [{"дата": ISODate ("2014-11-19T00: 00: 00Z"), "класс": "Как
core ": 11}, {" date ": ISODate (" 2013-11-14T00: 00: 00Z ")," grade ":" A "," score ": 2}, {" date ": ISODate (" 2012 -12-05T00: 00: 00Z ")," оценка ":" A "," оценка ": 13}, {" дата ": ISODate (" 2012-05-17T00: 00: 00Z ")," оценка ": "A", "score": 11}], "name": "Подвижный праздник", "restaurant_id": "40361606"}
{"_id": ObjectId ("55c3043ab165fa6355ec5ca1"), "address": {"building": "730", "corre": [-73.96805719999999, 40.7925587], "street": "Columbus Avenue", "zipcode": " 10025 "}," городской округ ":" Манхэттен "," кухня ":" американская "," классы ": [{" date ": ISODate (" 2014-09-12T00: 00: 00Z ")," grade ":" В
"," оценка ": 26}, {" дата ": ISODate (" 2013-08-28T00: 00: 00Z ")," оценка ":" А "," оценка ": 9}, {" дата ": ISODate ("2013-03-25T00: 00: 00Z"), "оценка": "B", "оценка": 20}, {"дата": ISODate ("2012-02-14T00: 00: 00Z"), " оценка ":" A "," оценка ": 12}]," имя ":" P & S Deli Grocery "," restaurant_id ":" 40362
264 "}
{"_id": ObjectId ("55c3043ab165fa6355ec5ca2"), "address": {"building": "18", "ord": [-73.996984, 40.72589], "street": "West West Houston Street", "почтовый индекс": "10012"}, "городской округ": "Манхэттен", "кухня": "американская", "классы": [{"дата": ISODate ("2014-04-03T00: 00: 00Z"), "класс": "A", "Sco
re ": 9}, {" дата ": ISODate (" 2013-04-05T00: 00: 00Z ")," оценка ":" A "," оценка ": 4}, {" дата ": ISODate (" 2012 -03-21T00: 00: 00Z ")," оценка ":" A "," оценка ": 13}, {" дата ": ISODate (" 2011-04-27T00: 00: 00Z ")," оценка ": "A", "score": 5}], "name": "Angelika Film Centre", "restaurant_id": "40362274"}

Поведение

Нулевое значение

Значение limit (), равное 0 (т.е. .limit (0)), эквивалентно установке без ограничения.

Отрицательные значения

Отрицательный предел аналогичен положительному пределу, но закрывает курсор после возврата одного пакета результатов. Таким образом, с отрицательным пределом, если ограниченный набор результатов не помещается в один пакет, количество полученных документов будет меньше указанного предела. Передав отрицательный лимит, клиент указывает серверу, что не будет запрашивать последующий пакет через getMore.

Предыдущий: cursor.itcount () метод
Далее: метод cursor.map ()