Cloud Firestore menyediakan fungsionalitas kueri yang andal untuk menentukan dokumen mana yang ingin Anda ambil dari koleksi. Kueri ini juga dapat digunakan dengan get()
atau addSnapshotListener()
, seperti yang dijelaskan dalam Get Data .
Memesan dan membatasi data
Secara default, kueri mengambil semua dokumen yang memenuhi kueri dalam urutan menaik menurut ID dokumen. Anda dapat menentukan tata urutan untuk data Anda menggunakan orderBy()
, dan Anda dapat membatasi jumlah dokumen yang diambil menggunakan limit()
.
Misalnya, Anda dapat meminta 3 kota pertama menurut abjad dengan:
Web version 9
import { query, orderBy, limit } from "firebase/firestore"; const q = query(citiesRef, orderBy("name"), limit(3));
Web version 8
citiesRef.orderBy("name").limit(3);
Cepat
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);
Jawa
Piton
Python
C++
cities_ref.OrderBy("name").Limit(3);
Node.js
Pergi
PHP
PHP
Untuk mengetahui selengkapnya tentang menginstal dan membuat klien Cloud Firestore, lihat Perpustakaan Klien Cloud Firestore .
Persatuan
Query query = citiesRef.OrderBy("Name").Limit(3);
C#
Rubi
Anda juga dapat mengurutkan dalam urutan menurun untuk mendapatkan 3 kota terakhir :
Web version 9
import { query, orderBy, limit } from "firebase/firestore"; const q = query(citiesRef, orderBy("name", "desc"), limit(3));
Web version 8
citiesRef.orderBy("name", "desc").limit(3);
Cepat
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);
Jawa
Piton
Python
C++
cities_ref.OrderBy("name", Query::Direction::kDescending).Limit(3);
Node.js
Pergi
PHP
PHP
Untuk mengetahui selengkapnya tentang menginstal dan membuat klien Cloud Firestore, lihat Perpustakaan Klien Cloud Firestore .
Persatuan
Query query = citiesRef.OrderByDescending("Name").Limit(3);
C#
Rubi
Anda juga dapat mengurutkan berdasarkan beberapa bidang. Misalnya, jika Anda ingin mengurutkan berdasarkan negara bagian, dan di setiap negara bagian, urutkan berdasarkan populasi dalam urutan menurun:
Web version 9
import { query, orderBy } from "firebase/firestore"; const q = query(citiesRef, orderBy("state"), orderBy("population", "desc"));
Web version 8
citiesRef.orderBy("state").orderBy("population", "desc");
Cepat
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);
Jawa
Piton
Python
C++
cities_ref.OrderBy("state").OrderBy("name", Query::Direction::kDescending);
Node.js
Pergi
PHP
PHP
Untuk mengetahui selengkapnya tentang menginstal dan membuat klien Cloud Firestore, lihat Perpustakaan Klien Cloud Firestore .
Persatuan
Query query = citiesRef.OrderBy("State").OrderByDescending("Population");
C#
Rubi
Anda dapat menggabungkan filter where where()
dengan orderBy()
dan limit()
. Dalam contoh berikut, kueri menentukan ambang populasi, mengurutkan berdasarkan populasi dalam urutan menaik, dan mengembalikan hanya beberapa hasil pertama yang melebihi ambang:
Web version 9
import { query, where, orderBy, limit } from "firebase/firestore"; const q = query(citiesRef, where("population", ">", 100000), orderBy("population"), limit(2));
Web version 8
citiesRef.where("population", ">", 100000).orderBy("population").limit(2);
Cepat
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);
Jawa
Piton
Python
C++
cities_ref.WhereGreaterThan("population", FieldValue::Integer(100000)) .OrderBy("population") .Limit(2);
Node.js
Pergi
PHP
PHP
Untuk mengetahui selengkapnya tentang menginstal dan membuat klien Cloud Firestore, lihat Perpustakaan Klien Cloud Firestore .
Persatuan
Query query = citiesRef .WhereGreaterThan("Population", 2500000) .OrderBy("Population") .Limit(2);
C#
Rubi
Namun, jika Anda memiliki filter dengan perbandingan rentang ( <
, <=
, >
, >=
), pengurutan pertama Anda harus berada di kolom yang sama, lihat daftar batasan orderBy()
di bawah.
Keterbatasan
Perhatikan batasan berikut untuk klausa orderBy()
:
-
orderBy()
juga memfilter keberadaan bidang yang diberikan. Kumpulan hasil tidak akan menyertakan dokumen yang tidak berisi bidang yang diberikan. Jika Anda menyertakan filter dengan perbandingan rentang (
<
,<=
,>
,>=
), pengurutan pertama Anda harus berada di bidang yang sama:Valid : Range filter dan
orderBy
pada kolom yang samaWeb version 9
import { query, where, orderBy } from "firebase/firestore"; const q = query(citiesRef, where("population", ">", 100000), orderBy("population"));
Web version 8
citiesRef.where("population", ">", 100000).orderBy("population");
Cepat
Catatan: Produk ini tidak tersedia di watchOS dan target Cuplikan Aplikasi.citiesRef .whereField("population", isGreaterThan: 100000) .order(by: "population")
Objective-C
Catatan: Produk ini tidak tersedia di watchOS dan target Cuplikan Aplikasi.[[citiesRef queryWhereField:@"population" isGreaterThan:@100000] queryOrderedByField:@"population"];
Kotlin+KTX
citiesRef.whereGreaterThan("population", 100000).orderBy("population")
Java
citiesRef.whereGreaterThan("population", 100000).orderBy("population");
Dart
final citiesRef = db.collection("cities"); citiesRef.where("population", isGreaterThan: 100000).orderBy("population");
Jawa
Query query = cities.whereGreaterThan("population", 2500000L).orderBy("population");
Piton
Python
Node.js
Pergi
PHP
PHP
Untuk mengetahui selengkapnya tentang menginstal dan membuat klien Cloud Firestore, lihat Perpustakaan Klien Cloud Firestore .
Persatuan
Query query = citiesRef .WhereGreaterThan("Population", 2500000) .OrderBy("Population");
C#
Rubi
Tidak valid : Filter rentang dan pesanan pertama
orderBy
pada bidang yang berbedaWeb version 9
import { query, where, orderBy } from "firebase/firestore"; const q = query(citiesRef, where("population", ">", 100000), orderBy("country"));
Web version 8
citiesRef.where("population", ">", 100000).orderBy("country");
Cepat
Catatan: Produk ini tidak tersedia di watchOS dan target Cuplikan Aplikasi.citiesRef .whereField("population", isGreaterThan: 100000) .order(by: "country")
Objective-C
Catatan: Produk ini tidak tersedia di watchOS dan target Cuplikan Aplikasi.[[citiesRef queryWhereField:@"population" isGreaterThan:@100000] queryOrderedByField:@"country"];
Kotlin+KTX
citiesRef.whereGreaterThan("population", 100000).orderBy("country")
Java
citiesRef.whereGreaterThan("population", 100000).orderBy("country");
Dart
final citiesRef = db.collection("cities"); citiesRef.where("population", isGreaterThan: 100000).orderBy("country");
Jawa
Piton
Python
C++
// BAD EXAMPLE -- will crash the program: cities_ref.WhereGreaterThan("population", FieldValue::Integer(100000)) .OrderBy("country");
Node.js
Pergi
PHP
PHP
Untuk mengetahui selengkapnya tentang menginstal dan membuat klien Cloud Firestore, lihat Perpustakaan Klien Cloud Firestore .
Persatuan
Query query = citiesRef .WhereGreaterThan("Population", 2500000) .OrderBy("Country");
C#
Rubi
- Anda tidak dapat mengurutkan kueri berdasarkan bidang apa pun yang disertakan dalam kesetaraan (
=
) atauin
klausa.