Firestore Enterprise edition with MongoDB compatibility is now available! Learn more.

Trang này được dịch bởi Cloud Translation API.

Đặt hàng và giới hạn dữ liệu bằng Cloud Firestore

Cloud Firestore cung cấp chức năng truy vấn mạnh mẽ để chỉ định những tài liệu mà bạn muốn truy xuất từ một bộ sưu tập. Bạn cũng có thể dùng các truy vấn này với get() hoặc addSnapshotListener(), như mô tả trong phần Nhận dữ liệu.

Sắp xếp và giới hạn dữ liệu

Theo mặc định, một truy vấn sẽ truy xuất tất cả các tài liệu đáp ứng truy vấn theo thứ tự tăng dần theo mã nhận dạng tài liệu. Bạn có thể chỉ định thứ tự sắp xếp cho dữ liệu bằng cách sử dụng orderBy() và có thể giới hạn số lượng tài liệu được truy xuất bằng cách sử dụng limit(). Nếu bạn chỉ định limit(), giá trị phải lớn hơn hoặc bằng 0.

Ví dụ: bạn có thể truy vấn 3 thành phố đầu tiên theo bảng chữ cái bằng cách:

Web

import { query, orderBy, limit } from "firebase/firestore";  

const q = query(citiesRef, orderBy("name"), limit(3));order_and_limit.js

Web

citiesRef.orderBy("name").limit(3);test.firestore.js

Swift

Lưu ý: Sản phẩm này không có trên các mục tiêu watchOS và App Clip.

citiesRef.order(by: "name").limit(to: 3)ViewController.swift

Objective-C

Lưu ý: Sản phẩm này không có trên các mục tiêu watchOS và App Clip.

[[citiesRef queryOrderedByField:@"name"] queryLimitedTo:3];ViewController.m

Kotlin

citiesRef.orderBy("name").limit(3)DocSnippets.kt

Java

citiesRef.orderBy("name").limit(3);DocSnippets.java

Dart

final citiesRef = db.collection("cities");
citiesRef.orderBy("name").limit(3);firestore.dart

Java

Query query = cities.orderBy("name").limit(3);
Query query = cities.orderBy("name").limitToLast(3);QueryDataSnippets.java

Python

cities_ref = db.collection("cities")
query = cities_ref.order_by("name").limit_to_last(2)
results = query.get()snippets.py

Python

cities_ref = db.collection("cities")
query = cities_ref.order_by("name").limit_to_last(2)
results = await query.get()snippets.py

C++

cities_ref.OrderBy("name").Limit(3);snippets.cpp

Node.js

const firstThreeRes = await citiesRef.orderBy('name').limit(3).get();index.js

Tìm

query := cities.OrderBy("name", firestore.Asc).Limit(3)
query := cities.OrderBy("name", firestore.Asc).LimitToLast(3)query.go

PHP

Để biết thêm thông tin về cách cài đặt và tạo ứng dụng Cloud Firestore, hãy tham khảo Thư viện ứng dụng Cloud Firestore.

$query = $citiesRef->orderBy('name')->limit(3);query_order_limit.php

Unity

Query query = citiesRef.OrderBy("Name").Limit(3);

C#

Query query = citiesRef.OrderBy("Name").Limit(3);Program.cs

Ruby

query = cities_ref.order("name").limit(3)order_limit_data.rb

Bạn cũng có thể sắp xếp theo thứ tự giảm dần để lấy 3 thành phố gần đây nhất:

Web

import { query, orderBy, limit } from "firebase/firestore";  

const q = query(citiesRef, orderBy("name", "desc"), limit(3));order_and_limit_desc.js

Web

citiesRef.orderBy("name", "desc").limit(3);test.firestore.js

Swift

Lưu ý: Sản phẩm này không có trên các mục tiêu watchOS và App Clip.

citiesRef.order(by: "name", descending: true).limit(to: 3)ViewController.swift

Objective-C

Lưu ý: Sản phẩm này không có trên các mục tiêu watchOS và App Clip.

[[citiesRef queryOrderedByField:@"name" descending:YES] queryLimitedTo:3];ViewController.m

Kotlin

citiesRef.orderBy("name", Query.Direction.DESCENDING).limit(3)DocSnippets.kt

Java

citiesRef.orderBy("name", Direction.DESCENDING).limit(3);DocSnippets.java

Dart

final citiesRef = db.collection("cities");
citiesRef.orderBy("name", descending: true).limit(3);firestore.dart

Java

Query query = cities.orderBy("name", Direction.DESCENDING).limit(3);QueryDataSnippets.java

Python

cities_ref = db.collection("cities")
query = cities_ref.order_by("name", direction=firestore.Query.DESCENDING).limit(3)
results = query.stream()snippets.py

Python

cities_ref = db.collection("cities")
query = cities_ref.order_by("name", direction=firestore.Query.DESCENDING).limit(3)
results = query.stream()snippets.py

C++

cities_ref.OrderBy("name", Query::Direction::kDescending).Limit(3);snippets.cpp

Node.js

const lastThreeRes = await citiesRef.orderBy('name', 'desc').limit(3).get();index.js

Tìm

query := cities.OrderBy("name", firestore.Desc).Limit(3)query.go

PHP

Để biết thêm thông tin về cách cài đặt và tạo ứng dụng Cloud Firestore, hãy tham khảo Thư viện ứng dụng Cloud Firestore.

$query = $citiesRef->orderBy('name', 'DESC')->limit(3);query_order_desc_limit.php

Unity

Query query = citiesRef.OrderByDescending("Name").Limit(3);

C#

Query query = citiesRef.OrderByDescending("Name").Limit(3);Program.cs

Ruby

query = cities_ref.order("name", "desc").limit(3)order_limit_data.rb

Bạn cũng có thể sắp xếp theo nhiều trường. Ví dụ: nếu bạn muốn sắp xếp theo tiểu bang và trong mỗi tiểu bang, hãy sắp xếp theo dân số theo thứ tự giảm dần:

Web

import { query, orderBy } from "firebase/firestore";  

const q = query(citiesRef, orderBy("state"), orderBy("population", "desc"));order_multiple.js

Web

citiesRef.orderBy("state").orderBy("population", "desc");test.firestore.js

Swift

Lưu ý: Sản phẩm này không có trên các mục tiêu watchOS và App Clip.

citiesRef
  .order(by: "state")
  .order(by: "population", descending: true)ViewController.swift

Objective-C

Lưu ý: Sản phẩm này không có trên các mục tiêu watchOS và App Clip.

[[citiesRef queryOrderedByField:@"state"] queryOrderedByField:@"population" descending:YES];ViewController.m

Kotlin

citiesRef.orderBy("state").orderBy("population", Query.Direction.DESCENDING)DocSnippets.kt

Java

citiesRef.orderBy("state").orderBy("population", Direction.DESCENDING);DocSnippets.java

Dart

final citiesRef = db.collection("cities");
citiesRef.orderBy("state").orderBy("population", descending: true);firestore.dart

Java

Query query = cities.orderBy("state").orderBy("population", Direction.DESCENDING);QueryDataSnippets.java

Python

cities_ref = db.collection("cities")
ordered_city_ref = cities_ref.order_by("state").order_by(
    "population", direction=firestore.Query.DESCENDING
)snippets.py

Python

cities_ref = db.collection("cities")
cities_ref.order_by("state").order_by(
    "population", direction=firestore.Query.DESCENDING
)snippets.py

C++

cities_ref.OrderBy("state").OrderBy("name", Query::Direction::kDescending);snippets.cpp

Node.js

const byStateByPopRes = await citiesRef.orderBy('state').orderBy('population', 'desc').get();index.js

Tìm

query := client.Collection("cities").OrderBy("state", firestore.Asc).OrderBy("population", firestore.Desc)query.go

PHP

Để biết thêm thông tin về cách cài đặt và tạo ứng dụng Cloud Firestore, hãy tham khảo Thư viện ứng dụng Cloud Firestore.

$query = $citiesRef->orderBy('state')->orderBy('population', 'DESC');query_order_multi.php

Unity

Query query = citiesRef.OrderBy("State").OrderByDescending("Population");

C#

Query query = citiesRef.OrderBy("State").OrderByDescending("Population");Program.cs

Ruby

query = cities_ref.order("state").order("population", "desc")order_limit_data.rb

Bạn có thể kết hợp các bộ lọc where() với orderBy() và limit(). Trong ví dụ sau, các truy vấn xác định một ngưỡng dân số, sắp xếp theo dân số theo thứ tự tăng dần và chỉ trả về một vài kết quả đầu tiên vượt quá ngưỡng:

Web

import { query, where, orderBy, limit } from "firebase/firestore";  

const q = query(citiesRef, where("population", ">", 100000), orderBy("population"), limit(2));filter_and_order.js

Web

citiesRef.where("population", ">", 100000).orderBy("population").limit(2);test.firestore.js

Swift

Lưu ý: Sản phẩm này không có trên các mục tiêu watchOS và App Clip.

citiesRef
  .whereField("population", isGreaterThan: 100000)
  .order(by: "population")
  .limit(to: 2)ViewController.swift

Objective-C

Lưu ý: Sản phẩm này không có trên các mục tiêu watchOS và App Clip.

[[[citiesRef queryWhereField:@"population" isGreaterThan:@100000]
    queryOrderedByField:@"population"]
    queryLimitedTo:2];ViewController.m

Kotlin

citiesRef.whereGreaterThan("population", 100000).orderBy("population").limit(2)DocSnippets.kt

Java

citiesRef.whereGreaterThan("population", 100000).orderBy("population").limit(2);DocSnippets.java

Dart

final citiesRef = db.collection("cities");
citiesRef
    .where("population", isGreaterThan: 100000)
    .orderBy("population")
    .limit(2);firestore.dart

Java

Query query = cities.whereGreaterThan("population", 2500000L).orderBy("population").limit(2);QueryDataSnippets.java

Python

cities_ref = db.collection("cities")
query = (
    cities_ref.where(filter=FieldFilter("population", ">", 2500000))
    .order_by("population")
    .limit(2)
)
results = query.stream()snippets.py

Python

cities_ref = db.collection("cities")
query = (
    cities_ref.where(filter=FieldFilter("population", ">", 2500000))
    .order_by("population")
    .limit(2)
)
results = query.stream()snippets.py

C++

cities_ref.WhereGreaterThan("population", FieldValue::Integer(100000))
    .OrderBy("population")
    .Limit(2);snippets.cpp

Node.js

const biggestRes = await citiesRef.where('population', '>', 2500000)
  .orderBy('population').limit(2).get();index.js

Tìm

query := cities.Where("population", ">", 2500000).OrderBy("population", firestore.Desc).Limit(2)query.go

PHP

Để biết thêm thông tin về cách cài đặt và tạo ứng dụng Cloud Firestore, hãy tham khảo Thư viện ứng dụng Cloud Firestore.

$query = $citiesRef
    ->where('population', '>', 2500000)
    ->orderBy('population')
    ->limit(2);query_order_limit_field_valid.php

Unity

Query query = citiesRef
    .WhereGreaterThan("Population", 2500000)
    .OrderBy("Population")
    .Limit(2);

C#

Query query = citiesRef
    .WhereGreaterThan("Population", 2500000)
    .OrderBy("Population")
    .Limit(2);Program.cs

Ruby

query = cities_ref.where("population", ">", 2_500_000).order("population").limit(2)order_limit_data.rb

Tuy nhiên, nếu có bộ lọc so sánh theo phạm vi (<, <=, >, >=), thì bạn phải sắp xếp theo trường đầu tiên, hãy xem danh sách các giới hạn orderBy() bên dưới.

Các điểm hạn chế

Xin lưu ý hạn chế sau đối với các mệnh đề orderBy():

Mệnh đề orderBy() cũng lọc sự tồn tại của các trường đã cho. Tập kết quả sẽ không bao gồm những tài liệu không chứa các trường đã cho.

`orderBy` và sự tồn tại

Khi bạn sắp xếp một truy vấn theo một trường nhất định, truy vấn chỉ có thể trả về những tài liệu có trường sắp xếp.

Ví dụ: truy vấn sau đây sẽ không trả về bất kỳ tài liệu nào mà trường population chưa được đặt, ngay cả khi các tài liệu đó đáp ứng các bộ lọc truy vấn.

Java

db.collection("cities").whereEqualTo("country", “USA”).orderBy(“population”);

Một hiệu ứng liên quan áp dụng cho các bất đẳng thức. Một truy vấn có bộ lọc bất đẳng thức trên một trường cũng ngụ ý việc sắp xếp theo trường đó. Truy vấn sau đây không trả về các tài liệu không có trường population ngay cả khi country = USA trong tài liệu đó . Để khắc phục, bạn có thể thực hiện các truy vấn riêng biệt cho từng thứ tự hoặc bạn có thể chỉ định một giá trị cho tất cả các trường mà bạn sắp xếp theo.

Java

db.collection(“cities”).where(or(“country”, USA”), greaterThan(“population”, 250000));

Truy vấn ở trên bao gồm một mệnh đề order-by ngầm định về sự không bình đẳng và tương đương với truy vấn sau:

Java

db.collection(“cities”).where(or(“country”, USA”), greaterThan(“population”, 250000)).orderBy(“population”);

Đặt hàng và giới hạn dữ liệu bằng Cloud Firestore Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.

Sắp xếp và giới hạn dữ liệu

Web

Web

Swift

Objective-C

Kotlin

Java

Dart

Java

Python

Python

C++

Node.js

Tìm

PHP

PHP

Unity

C#

Ruby

Web

Web

Swift

Objective-C

Kotlin

Java

Dart

Java

Python

Python

C++

Node.js

Tìm

PHP

PHP

Unity

C#

Ruby

Web

Web

Swift

Objective-C

Kotlin

Java

Dart

Java

Python

Python

C++

Node.js

Tìm

PHP

PHP

Unity

C#

Ruby

Web

Web

Swift

Objective-C

Kotlin

Java

Dart

Java

Python

Python

C++

Node.js

Tìm

PHP

PHP

Unity

C#

Ruby

Các điểm hạn chế

orderBy và sự tồn tại

Java

Java

Java

Đặt hàng và giới hạn dữ liệu bằng Cloud Firestore

`orderBy` và sự tồn tại