Cloud Firestore udostępnia zaawansowane funkcje zapytań służące do określania, które:
dokumenty, które chcesz pobrać z kolekcji. Tych zapytań można też używać
za pomocą get()
lub addSnapshotListener()
, zgodnie z opisem w sekcji Pobieranie
Dane.
Dane dotyczące zamówień i limitów
Domyślnie zapytanie pobiera wszystkie dokumenty pasujące do zapytania, rosnąco
kolejność według identyfikatora dokumentu. Możesz określić kolejność sortowania danych za pomocą funkcji
orderBy()
. Możesz też ograniczyć liczbę pobieranych dokumentów za pomocą
limit()
Jeśli podasz limit()
, wartość musi być większa lub równa
do zera.
Możesz np. wpisać alfabetycznie zapytanie o pierwsze 3 miasta, z:
Web
import { query, orderBy, limit } from "firebase/firestore"; const q = query(citiesRef, orderBy("name"), limit(3));
Web
citiesRef.orderBy("name").limit(3);
Swift
citiesRef.order(by: "name").limit(to: 3)
Objective-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);
Java
Python
Python
C++
cities_ref.OrderBy("name").Limit(3);
Node.js
Go
PHP
PHP
Więcej informacji o instalowaniu i tworzeniu klienta Cloud Firestore znajdziesz tutaj: Biblioteki klienta Cloud Firestore.
Unity
Query query = citiesRef.OrderBy("Name").Limit(3);
C#
Ruby
Możesz też posortować listę malejąco, by wyświetlić ostatnie 3 miasta:
Web
import { query, orderBy, limit } from "firebase/firestore"; const q = query(citiesRef, orderBy("name", "desc"), limit(3));
Web
citiesRef.orderBy("name", "desc").limit(3);
Swift
citiesRef.order(by: "name", descending: true).limit(to: 3)
Objective-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);
Java
Python
Python
C++
cities_ref.OrderBy("name", Query::Direction::kDescending).Limit(3);
Node.js
Go
PHP
PHP
Więcej informacji o instalowaniu i tworzeniu klienta Cloud Firestore znajdziesz tutaj: Biblioteki klienta Cloud Firestore.
Unity
Query query = citiesRef.OrderByDescending("Name").Limit(3);
C#
Ruby
Możesz też sortować według wielu pól. Jeśli na przykład chcesz posortować produkty według stanu, a w ramach każdego stanu według liczby ludności w kolejności malejącej:
Web
import { query, orderBy } from "firebase/firestore"; const q = query(citiesRef, orderBy("state"), orderBy("population", "desc"));
Web
citiesRef.orderBy("state").orderBy("population", "desc");
Swift
citiesRef .order(by: "state") .order(by: "population", descending: true)
Objective-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);
Java
Python
Python
C++
cities_ref.OrderBy("state").OrderBy("name", Query::Direction::kDescending);
Node.js
Go
PHP
PHP
Więcej informacji o instalowaniu i tworzeniu klienta Cloud Firestore znajdziesz tutaj: Biblioteki klienta Cloud Firestore.
Unity
Query query = citiesRef.OrderBy("State").OrderByDescending("Population");
C#
Ruby
Filtry where()
możesz łączyć z filtrami orderBy()
i limit()
. W
w kolejnym przykładzie zapytania definiują próg populacji, sortując według populacji
rosnąco i zwraca tylko kilka pierwszych wyników, które przekraczają
próg:
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);
Swift
citiesRef .whereField("population", isGreaterThan: 100000) .order(by: "population") .limit(to: 2)
Objective-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);
Java
Python
Python
C++
cities_ref.WhereGreaterThan("population", FieldValue::Integer(100000)) .OrderBy("population") .Limit(2);
Node.js
Go
PHP
PHP
Więcej informacji o instalowaniu i tworzeniu klienta Cloud Firestore znajdziesz tutaj: Biblioteki klienta Cloud Firestore.
Unity
Query query = citiesRef .WhereGreaterThan("Population", 2500000) .OrderBy("Population") .Limit(2);
C#
Ruby
Jeśli jednak masz filtr z porównaniem zakresów (<
, <=
, >
, >=
),
pierwsze zamówienie musi znajdować się w tym samym polu; zobacz listę orderBy()
opisane poniżej ograniczenia.
Ograniczenia
Zwróć uwagę na to ograniczenie dotyczące klauzul orderBy()
:
- Klauzula
orderBy()
filtruje też dane pod kątem istnienia podanych pól. Zestaw wyników nie będzie zawierał dokumentów, które nie zawierają podanych pól.
orderBy
a istnienie
Po uporządkowaniu zapytania według danego pola zapytanie może zwrócić tylko dokumenty z polem sortowania.
Na przykład poniższe zapytanie nie zwróci żadnych dokumentów, w których
Pole population
nie jest ustawione, nawet jeśli są zgodne z filtrami zapytania.
Java
db.collection("cities").whereEqualTo("country", “USA”).orderBy(“population”);
Powiązany efekt ma zastosowanie do nierówności. Zapytanie z filtrem nierówności
oznacza również sortowanie według tego pola. Poniżej
nie zwraca dokumentów bez pola population
nawet
jeśli country = USA
w tym dokumencie . Aby obejść ten problem, możesz uruchomić
osobne zapytania dla każdej kolejności lub możesz przypisać wartość wszystkim polom.
według których składasz zamówienie.
Java
db.collection(“cities”).where(or(“country”, USA”), greaterThan(“population”, 250000));
Powyższe zapytanie zawiera domniemane porządkowanie nierówności i jest odpowiednikowi:
Java
db.collection(“cities”).where(or(“country”, USA”), greaterThan(“population”, 250000)).orderBy(“population”);