Catch up on highlights from Firebase at Google I/O 2023. Learn more

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

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

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

Đặt hàng 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 ID tài liệu. Bạn có thể chỉ định thứ tự sắp xếp cho dữ liệu của mình bằng cách sử dụng orderBy() và bạn 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() thì 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 thứ tự bảng chữ cái với:

Web modular API

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

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

Web namespaced API

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

Nhanh

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

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

Mục tiêu-C

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

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

Kotlin+KTX

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

Đi

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

PHP

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

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

Đoàn kết

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

C#

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

hồng ngọc

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 để có được 3 thành phố cuối cùng :

Web modular API

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

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

Web namespaced API

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

Nhanh

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

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

Mục tiêu-C

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

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

Kotlin+KTX

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

Đi

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

PHP

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

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

Đoàn kết

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

C#

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

hồng ngọc

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

Bạn cũng có thể đặt hàng theo nhiều lĩnh vực. 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 modular API

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

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

Web namespaced API

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

Nhanh

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

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

Mục tiêu-C

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

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

Kotlin+KTX

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")
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

Đi

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

PHP

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

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

Đoàn kết

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

C#

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

hồng ngọc

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 ngưỡng tổng thể, sắp xếp theo tổng thể 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 modular API

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

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

Web namespaced API

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

Nhanh

Lưu ý: Sản phẩm này không khả dụng 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

Mục tiêu-C

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

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

Kotlin+KTX

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

Đi

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

PHP

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

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

Đoàn kết

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

C#

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

hồng ngọc

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

Tuy nhiên, nếu bạn có bộ lọc có so sánh phạm vi ( < , <= , > , >= ), đơn hàng đầu tiên của bạn phải nằm trên cùng một trường, hãy xem danh sách giới hạn orderBy() bên dưới.

Hạn chế

Lưu ý các hạn chế sau đây đối với 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 các tài liệu không chứa các trường nhất định.

Nếu bạn bao gồm bộ lọc có so sánh phạm vi ( < , <= , > , >= ), đơn hàng đầu tiên của bạn phải nằm trên cùng một trường:

Hợp lệ : Bộ lọc phạm vi và orderBy trên cùng một trường

Web modular API

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

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

Web namespaced API

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

Nhanh

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

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

Mục tiêu-C

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

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

Kotlin+KTX

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

Java

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

Dart

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

Java

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

Python

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

Python

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

Node.js

citiesRef.where('population', '>', 2500000).orderBy('population');index.js

Đi

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

PHP

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

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

Đoàn kết

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

C#

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

hồng ngọc

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

Không hợp lệ : Bộ lọc phạm vi và orderBy đầu tiênBy trên các trường khác nhau

Web modular API

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

const q = query(citiesRef, where("population", ">", 100000), orderBy("country"));invalid_filter_and_order.js

Web namespaced API

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

Nhanh

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

citiesRef
    .whereField("population", isGreaterThan: 100000)
    .order(by: "country")ViewController.swift

Mục tiêu-C

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

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

Kotlin+KTX

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

Java

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

Dart

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

Java

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

Python

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

Python

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

C++

// BAD EXAMPLE -- will crash the program:
cities_ref.WhereGreaterThan("population", FieldValue::Integer(100000))
    .OrderBy("country");snippets.cpp

Node.js

citiesRef.where('population', '>', 2500000).orderBy('country');index.js

Đi

// Note: This is an invalid query. It violates the constraint that range
// and order by are required to be on the same field.
query := cities.Where("population", ">", 2500000).OrderBy("country", firestore.Asc)query.go

PHP

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

$invalidRangeQuery = $citiesRef
    ->where('population', '>', 2500000)
    ->orderBy('country');query_order_field_invalid.php

Đoàn kết

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

C#

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

hồng ngọc

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

`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ó tồn tại trường theo thứ tự đó.

Ví dụ: truy vấn sau sẽ không trả về bất kỳ tài liệu nào mà trường population không được đặt, ngay cả khi chúng đá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 sự bất bình đẳng. Truy vấn có bộ lọc bất đẳng thức trên một trường cũng bao hàm việc sắp xếp theo trường đó. Truy vấn sau đây không trả về 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 đơn hàng 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 thứ tự ngụ ý về bất đẳng thức và tương đương với truy vấn sau:

Java

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