Cloud Firestore มีฟังก์ชันการค้นหาที่มีประสิทธิภาพสำหรับการระบุเอกสารที่ต้องการดึงข้อมูลจากคอลเล็กชัน นอกจากนี้ คุณยังใช้ข้อความค้นหาเหล่านี้กับ get()
หรือ addSnapshotListener()
ได้ด้วยตามที่อธิบายไว้ในรับข้อมูล
ข้อมูลการสั่งซื้อและขีดจํากัด
โดยค่าเริ่มต้น การค้นหาจะดึงข้อมูลเอกสารทั้งหมดที่ตรงกับการค้นหาตามลําดับจากน้อยไปมากตามรหัสเอกสาร คุณสามารถระบุลําดับการจัดเรียงข้อมูลได้โดยใช้ orderBy()
และจํากัดจํานวนเอกสารที่ดึงข้อมูลได้โดยใช้ limit()
หากระบุ limit()
ค่าต้องมากกว่าหรือเท่ากับ 0
เช่น คุณอาจค้นหาเมือง 3 อันดับแรกตามลําดับตัวอักษร ด้วย
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
ดูข้อมูลเพิ่มเติมเกี่ยวกับการติดตั้งและสร้างไคลเอ็นต์ Cloud Firestore ได้ที่Cloud Firestore ไลบรารีไคลเอ็นต์
Unity
Query query = citiesRef.OrderBy("Name").Limit(3);
C#
Ruby
นอกจากนี้ คุณยังจัดเรียงตามลำดับจากมากไปน้อยเพื่อดู 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);
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
ดูข้อมูลเพิ่มเติมเกี่ยวกับการติดตั้งและสร้างไคลเอ็นต์ Cloud Firestore ได้ที่Cloud Firestore ไลบรารีไคลเอ็นต์
Unity
Query query = citiesRef.OrderByDescending("Name").Limit(3);
C#
Ruby
นอกจากนี้ คุณยังจัดเรียงตามหลายช่องได้ด้วย ตัวอย่างเช่น หากต้องการจัดเรียงตามรัฐ และภายในแต่ละรัฐจัดเรียงตามจำนวนประชากรจากมากไปน้อย ให้ทำดังนี้
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
ดูข้อมูลเพิ่มเติมเกี่ยวกับการติดตั้งและสร้างไคลเอ็นต์ Cloud Firestore ได้ที่Cloud Firestore ไลบรารีไคลเอ็นต์
Unity
Query query = citiesRef.OrderBy("State").OrderByDescending("Population");
C#
Ruby
คุณรวมตัวกรอง where()
เข้ากับ orderBy()
และ limit()
ได้ ในตัวอย่างนี้ การค้นหาจะกําหนดเกณฑ์ประชากร จัดเรียงตามประชากรจากน้อยไปมาก และแสดงเฉพาะผลลัพธ์แรกๆ 2-3 รายการที่เกินเกณฑ์
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
ดูข้อมูลเพิ่มเติมเกี่ยวกับการติดตั้งและสร้างไคลเอ็นต์ Cloud Firestore ได้ที่Cloud Firestore ไลบรารีไคลเอ็นต์
Unity
Query query = citiesRef .WhereGreaterThan("Population", 2500000) .OrderBy("Population") .Limit(2);
C#
Ruby
อย่างไรก็ตาม หากคุณมีตัวกรองที่มีการเปรียบเทียบช่วง (<
, <=
, >
, >=
) การสั่งซื้อครั้งแรกต้องอยู่ในช่องเดียวกัน ดูรายการข้อจำกัดของ orderBy()
ด้านล่าง
ข้อจำกัด
โปรดทราบข้อจำกัดต่อไปนี้สำหรับประโยค orderBy()
- ประโยค
orderBy()
ยังกรองหาช่องที่ระบุด้วย ชุดผลลัพธ์จะไม่รวมเอกสารที่ไม่มีฟิลด์ที่ระบุ
orderBy
และมีอยู่จริง
เมื่อคุณจัดเรียงการค้นหาตามช่องที่ระบุ การค้นหาจะแสดงเฉพาะเอกสารที่มีช่อง "จัดเรียงตาม"
ตัวอย่างเช่น การค้นหาต่อไปนี้จะไม่แสดงเอกสารใดๆ ที่ไม่ได้ตั้งค่าฟิลด์ population
แม้ว่าจะตรงกับตัวกรองการค้นหาก็ตาม
Java
db.collection("cities").whereEqualTo("country", “USA”).orderBy(“population”);
เอฟเฟกต์ที่เกี่ยวข้องจะมีผลกับความไม่เท่าเทียม การค้นหาที่มีตัวกรองความไม่เท่าเทียมในช่องหนึ่งๆ ยังหมายถึงการจัดเรียงตามช่องนั้นด้วย การค้นหาต่อไปนี้จะไม่แสดงผลเอกสารที่ไม่มีช่อง population
แม้ว่าจะมี country = USA
ในเอกสารนั้นก็ตาม วิธีแก้ปัญหาคือคุณสามารถเรียกใช้การค้นหาแยกต่างหากสําหรับการจัดเรียงแต่ละรายการ หรือกําหนดค่าสําหรับช่องทั้งหมดที่จัดเรียง
Java
db.collection(“cities”).where(or(“country”, USA”), greaterThan(“population”, 250000));
คําค้นหาข้างต้นมี order-by ที่ไม่ชัดแจ้งในความไม่เท่ากันและเทียบเท่ากับคําค้นหาต่อไปนี้
Java
db.collection(“cities”).where(or(“country”, USA”), greaterThan(“population”, 250000)).orderBy(“population”);