在 2024 年演示日活动中，观看有关如何使用 Firebase 构建和运行 AI 赋能应用的演示。立即观看。

این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

با Cloud Firestore داده ها را سفارش دهید و محدود کنید

Cloud Firestore عملکرد قدرتمند پرس و جو را برای تعیین اسنادی که می خواهید از یک مجموعه بازیابی کنید فراهم می کند. این کوئری ها همچنین می توانند با get() یا addSnapshotListener() استفاده شوند، همانطور که در Get Data توضیح داده شده است.

سفارش و محدود کردن داده ها

به طور پیش فرض، یک پرس و جو تمام اسنادی را که پرس و جو را برآورده می کنند به ترتیب صعودی با شناسه سند بازیابی می کند. می توانید ترتیب مرتب سازی داده های خود را با استفاده از orderBy() مشخص کنید و می توانید تعداد اسناد بازیابی شده را با استفاده از limit() محدود کنید. اگر یک limit() مشخص کنید، مقدار باید بزرگتر یا مساوی صفر باشد.

به عنوان مثال، شما می توانید 3 شهر اول را به ترتیب حروف الفبا با استفاده از:

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

سویفت

توجه: این محصول در اهداف watchOS و App Clip موجود نیست.

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

هدف-C

توجه: این محصول در اهداف watchOS و 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

جاوا

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

پایتون

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

برو

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

PHP

برای اطلاعات بیشتر در مورد نصب و ایجاد کلاینت Cloud Firestore ، به کتابخانه های سرویس گیرنده Cloud Firestore مراجعه کنید.

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

وحدت

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

سی شارپ

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

یاقوت سرخ

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

همچنین می توانید برای دریافت 3 شهر آخر به ترتیب نزولی مرتب کنید:

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

سویفت

توجه: این محصول در اهداف watchOS و App Clip موجود نیست.

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

هدف-C

توجه: این محصول در اهداف watchOS و 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

جاوا

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

پایتون

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

برو

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

PHP

برای اطلاعات بیشتر در مورد نصب و ایجاد کلاینت Cloud Firestore ، به کتابخانه های سرویس گیرنده Cloud Firestore مراجعه کنید.

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

وحدت

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

سی شارپ

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

یاقوت سرخ

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

همچنین می توانید بر اساس چندین فیلد سفارش دهید. به عنوان مثال، اگر می‌خواهید بر اساس ایالت و در هر ایالت به ترتیب جمعیت به ترتیب نزولی ترتیب دهید:

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

سویفت

توجه: این محصول در اهداف watchOS و App Clip موجود نیست.

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

هدف-C

توجه: این محصول در اهداف watchOS و 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

جاوا

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

پایتون

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

برو

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

PHP

برای اطلاعات بیشتر در مورد نصب و ایجاد کلاینت Cloud Firestore ، به کتابخانه های سرویس گیرنده Cloud Firestore مراجعه کنید.

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

وحدت

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

سی شارپ

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

یاقوت سرخ

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

می توانید فیلترهای where() را با orderBy() و limit() ترکیب کنید. در مثال زیر، پرس و جوها آستانه جمعیتی را تعریف می‌کنند، بر اساس جمعیت به ترتیب صعودی مرتب می‌شوند و تنها چند نتیجه اولی را که از آستانه فراتر می‌روند برمی‌گردانند:

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

سویفت

توجه: این محصول در اهداف watchOS و App Clip موجود نیست.

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

هدف-C

توجه: این محصول در اهداف watchOS و 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

جاوا

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

پایتون

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

برو

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

PHP

برای اطلاعات بیشتر در مورد نصب و ایجاد کلاینت Cloud Firestore ، به کتابخانه های سرویس گیرنده Cloud Firestore مراجعه کنید.

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

وحدت

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

سی شارپ

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

یاقوت سرخ

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

با این حال، اگر فیلتری با مقایسه محدوده دارید ( < ، <= ، > ، >= )، اولین سفارش شما باید در همان فیلد باشد، لیست محدودیت های orderBy() را در زیر ببینید.

محدودیت ها

برای بندهای orderBy() به محدودیت زیر توجه کنید:

یک عبارت orderBy() نیز وجود فیلدهای داده شده را فیلتر می کند . مجموعه نتایج شامل اسنادی که فیلدهای داده شده را ندارند، نمی شود.

`orderBy` و وجود

هنگامی که یک پرس و جو را بر اساس یک فیلد مشخص سفارش می دهید، پرس و جو فقط می تواند اسنادی را که فیلد ترتیب بر اساس وجود دارد، برگرداند.

برای مثال، جستار زیر هیچ سندی را که فیلد population تنظیم نشده است، باز نمی‌گرداند، حتی اگر در غیر این صورت فیلترهای پرس و جو را داشته باشند.

جاوا

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

یک اثر مرتبط برای نابرابری ها اعمال می شود. یک پرس و جو با فیلتر نابرابری در یک فیلد نیز به ترتیب بر اساس آن فیلد دلالت دارد. پرس و جوی زیر اسناد را بدون فیلد population باز نمی گرداند، حتی اگر country = USA در آن سند باشد. به‌عنوان راه‌حل، می‌توانید پرس‌و‌جوهای جداگانه‌ای را برای هر سفارش اجرا کنید یا می‌توانید برای تمام فیلدهایی که بر اساس آن‌ها سفارش می‌دهید، یک مقدار اختصاص دهید.

جاوا

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

پرس و جو فوق شامل یک ترتیب ضمنی در مورد نابرابری است و معادل موارد زیر است:

جاوا

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

با Cloud Firestore داده ها را سفارش دهید و محدود کنید

سفارش و محدود کردن داده ها

Web

Web

سویفت

هدف-C

Kotlin

Java

Dart

جاوا

پایتون

Python

C++

Node.js

برو

PHP

PHP

وحدت

سی شارپ

یاقوت سرخ

Web

Web

سویفت

هدف-C

Kotlin

Java

Dart

جاوا

پایتون

Python

C++

Node.js

برو

PHP

PHP

وحدت

سی شارپ

یاقوت سرخ

Web

Web

سویفت

هدف-C

Kotlin

Java

Dart

جاوا

پایتون

Python

C++

Node.js

برو

PHP

PHP

وحدت

سی شارپ

یاقوت سرخ

Web

Web

سویفت

هدف-C

Kotlin

Java

Dart

جاوا

پایتون

Python

C++

Node.js

برو

PHP

PHP

وحدت

سی شارپ

یاقوت سرخ

محدودیت ها

orderBy و وجود

جاوا

جاوا

جاوا

`orderBy` و وجود