Cloud Firestore предоставляет мощные функции запросов, позволяющие указать, какие документы вы хотите получить из коллекции. Эти запросы также можно использовать с помощью get()
или addSnapshotListener()
, как описано в разделе «Получение данных» .
Данные о заказах и лимитах
По умолчанию запрос извлекает все документы, удовлетворяющие запросу, в порядке возрастания идентификатора документа. Вы можете указать порядок сортировки ваших данных с помощью orderBy()
и ограничить количество извлекаемых документов с помощью limit()
. Если вы укажете limit()
, значение должно быть больше или равно нулю.
Например, вы можете запросить первые 3 города в алфавитном порядке с помощью:
Web
import { query, orderBy, limit } from "firebase/firestore"; const q = query(citiesRef, orderBy("name"), limit(3));
Web
citiesRef.orderBy("name").limit(3);
Быстрый
citiesRef.order(by: "name").limit(to: 3)
Цель-C
[[citiesRef queryOrderedByField:@"name"] queryLimitedTo:3];
Kotlin+KTX
citiesRef.orderBy("name").limit(3)
Java
citiesRef.orderBy("name").limit(3);
Dart
final citiesRef = db.collection("cities"); citiesRef.orderBy("name").limit(3);
Ява
Питон
Python
С++
cities_ref.OrderBy("name").Limit(3);
Node.js
Идти
PHP
PHP
Дополнительную информацию об установке и создании клиента Cloud Firestore см. в разделе Клиентские библиотеки Cloud Firestore .
Единство
Query query = citiesRef.OrderBy("Name").Limit(3);
С#
Руби
Вы также можете отсортировать по убыванию, чтобы получить последние 3 города:
Web
import { query, orderBy, limit } from "firebase/firestore"; const q = query(citiesRef, orderBy("name", "desc"), limit(3));
Web
citiesRef.orderBy("name", "desc").limit(3);
Быстрый
citiesRef.order(by: "name", descending: true).limit(to: 3)
Цель-C
[[citiesRef queryOrderedByField:@"name" descending:YES] queryLimitedTo:3];
Kotlin+KTX
citiesRef.orderBy("name", Query.Direction.DESCENDING).limit(3)
Java
citiesRef.orderBy("name", Direction.DESCENDING).limit(3);
Dart
final citiesRef = db.collection("cities"); citiesRef.orderBy("name", descending: true).limit(3);
Ява
Питон
Python
С++
cities_ref.OrderBy("name", Query::Direction::kDescending).Limit(3);
Node.js
Идти
PHP
PHP
Дополнительную информацию об установке и создании клиента Cloud Firestore см. в разделе Клиентские библиотеки Cloud Firestore .
Единство
Query query = citiesRef.OrderByDescending("Name").Limit(3);
С#
Руби
Вы также можете заказать по нескольким полям. Например, если вы хотите упорядочить по штатам и внутри каждого штата по населению в порядке убывания:
Web
import { query, orderBy } from "firebase/firestore"; const q = query(citiesRef, orderBy("state"), orderBy("population", "desc"));
Web
citiesRef.orderBy("state").orderBy("population", "desc");
Быстрый
citiesRef .order(by: "state") .order(by: "population", descending: true)
Цель-C
[[citiesRef queryOrderedByField:@"state"] queryOrderedByField:@"population" descending:YES];
Kotlin+KTX
citiesRef.orderBy("state").orderBy("population", Query.Direction.DESCENDING)
Java
citiesRef.orderBy("state").orderBy("population", Direction.DESCENDING);
Dart
final citiesRef = db.collection("cities"); citiesRef.orderBy("state").orderBy("population", descending: true);
Ява
Питон
Python
С++
cities_ref.OrderBy("state").OrderBy("name", Query::Direction::kDescending);
Node.js
Идти
PHP
PHP
Дополнительную информацию об установке и создании клиента Cloud Firestore см. в разделе Клиентские библиотеки Cloud Firestore .
Единство
Query query = citiesRef.OrderBy("State").OrderByDescending("Population");
С#
Руби
Вы можете комбинировать фильтрыwhere where()
с orderBy()
и limit()
. В следующем примере запросы определяют порог численности, сортируют по численности населения в порядке возрастания и возвращают только первые несколько результатов, превышающих порог:
Web
import { query, where, orderBy, limit } from "firebase/firestore"; const q = query(citiesRef, where("population", ">", 100000), orderBy("population"), limit(2));
Web
citiesRef.where("population", ">", 100000).orderBy("population").limit(2);
Быстрый
citiesRef .whereField("population", isGreaterThan: 100000) .order(by: "population") .limit(to: 2)
Цель-C
[[[citiesRef queryWhereField:@"population" isGreaterThan:@100000] queryOrderedByField:@"population"] queryLimitedTo:2];
Kotlin+KTX
citiesRef.whereGreaterThan("population", 100000).orderBy("population").limit(2)
Java
citiesRef.whereGreaterThan("population", 100000).orderBy("population").limit(2);
Dart
final citiesRef = db.collection("cities"); citiesRef .where("population", isGreaterThan: 100000) .orderBy("population") .limit(2);
Ява
Питон
Python
С++
cities_ref.WhereGreaterThan("population", FieldValue::Integer(100000)) .OrderBy("population") .Limit(2);
Node.js
Идти
PHP
PHP
Дополнительную информацию об установке и создании клиента Cloud Firestore см. в разделе Клиентские библиотеки Cloud Firestore .
Единство
Query query = citiesRef .WhereGreaterThan("Population", 2500000) .OrderBy("Population") .Limit(2);
С#
Руби
Однако если у вас есть фильтр со сравнением диапазонов ( <
, <=
, >
, >=
), ваш первый порядок должен быть в том же поле, см. список ограничений orderBy()
ниже.
Ограничения
Обратите внимание на следующее ограничение для предложений orderBy()
:
- Предложение
orderBy()
также фильтрует наличие заданных полей . В набор результатов не будут включены документы, не содержащие данные поля.
orderBy
и существование
Когда вы упорядочиваете запрос по заданному полю, запрос может возвращать только те документы, в которых существует поле упорядочивания.
Например, следующий запрос не вернет документы, в которых не задано поле population
, даже если в остальном они соответствуют фильтрам запроса.
Ява
db.collection("cities").whereEqualTo("country", “USA”).orderBy(“population”);
Похожий эффект применим и к неравенствам. Запрос с фильтром неравенства в поле также подразумевает упорядочивание по этому полю. Следующий запрос не возвращает документы без поля population
, даже если в этом документе country = USA
. В качестве обходного пути вы можете выполнить отдельные запросы для каждого порядка или присвоить значение всем полям, по которым вы упорядочиваете.
Ява
db.collection(“cities”).where(or(“country”, USA”), greaterThan(“population”, 250000));
Приведенный выше запрос включает в себя подразумеваемый порядок неравенства и эквивалентен следующему:
Ява
db.collection(“cities”).where(or(“country”, USA”), greaterThan(“population”, 250000)).orderBy(“population”);