مرتب‌سازی و محدود کردن داده‌ها با Cloud Firestore

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

توجه: اگرچه نمونه کدها چندین زبان را پوشش می‌دهند، نوشتار توضیح‌دهنده نمونه‌ها به نام‌های روش وب اشاره دارد.

داده‌های سفارش و محدودیت

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

توجه: عبارت orderBy() همچنین وجود فیلد داده‌شده را فیلتر می‌کند. مجموعه نتایج شامل اسنادی که فیلد ارائه‌شده را ندارند نخواهد بود.

برای مثال، می‌توانید ۳ شهر اول را به‌ترتیب حروف الفبا با این عبارت پُرسمان کنید:

Web

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

Swift

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

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

Objective-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

PHP

برای اصالت‌سنجی در Cloud Firestore، «اطلاعات اعتباری پیش‌فرض برنامه» را راه‌اندازی کنید. برای اطلاعات بیشتر، به راه‌اندازی اصالت‌سنجی برای محیط توسعه محلی مراجعه کنید.

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

Unity

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

سی شارپ

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

Ruby

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

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

Web

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

Swift

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

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

Objective-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

PHP

برای اصالت‌سنجی در Cloud Firestore، «اطلاعات اعتباری پیش‌فرض برنامه» را راه‌اندازی کنید. برای اطلاعات بیشتر، به راه‌اندازی اصالت‌سنجی برای محیط توسعه محلی مراجعه کنید.

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

Unity

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

سی شارپ

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

Ruby

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

درباره میانای برنامه‌سازی کاربردی وب مدولار با قابلیت حذف کدهای بلااستفاده و مزایای آن نسبت‌به namespaced API بیشتر بدانید.

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

Swift

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

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

Objective-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

PHP

برای اصالت‌سنجی در Cloud Firestore، «اطلاعات اعتباری پیش‌فرض برنامه» را راه‌اندازی کنید. برای اطلاعات بیشتر، به راه‌اندازی اصالت‌سنجی برای محیط توسعه محلی مراجعه کنید.

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

Unity

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

سی شارپ

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

Ruby

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

درباره میانای برنامه‌سازی کاربردی وب مدولار با قابلیت حذف کدهای بلااستفاده و مزایای آن نسبت‌به namespaced API بیشتر بدانید.

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

Swift

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

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

Objective-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

PHP

برای اصالت‌سنجی در Cloud Firestore، «اطلاعات اعتباری پیش‌فرض برنامه» را راه‌اندازی کنید. برای اطلاعات بیشتر، به راه‌اندازی اصالت‌سنجی برای محیط توسعه محلی مراجعه کنید.

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

Unity

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

سی شارپ

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

بااین‌حال، اگر فیلتری با مقایسه محدوده (<، <=، >، >=) دارید، اولین ترتیب شما باید در همان فیلد باشد، فهرست 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));

پُرسمان بالا شامل یک order-by ضمنی روی نابرابری است و معادل موارد زیر است:

جاوا

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