تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

طلب البيانات والحد منها باستخدام Cloud Firestore

يوفر Cloud Firestore وظائف استعلام قوية لتحديد المستندات التي تريد استردادها من مجموعة. يمكن أيضًا استخدام هذه الاستعلامات مع get() أو addSnapshotListener() ، كما هو موضح في Get Data .

طلب البيانات والحد منها

بشكل افتراضي ، يقوم الاستعلام باسترداد جميع المستندات التي تلبي الاستعلام بترتيب تصاعدي حسب معرف المستند. يمكنك تحديد ترتيب الفرز لبياناتك باستخدام orderBy() ، ويمكنك تحديد عدد المستندات المستردة باستخدام limit() . إذا حددت limit() ، يجب أن تكون القيمة أكبر من الصفر أو مساوية له.

على سبيل المثال ، يمكنك الاستعلام عن أول 3 مدن أبجديًا باستخدام:

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

سويفت

ملاحظة: هذا المنتج غير متوفر في أهداف watchOS و App Clip.

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

ج موضوعية

ملاحظة: هذا المنتج غير متوفر في أهداف watchOS و 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

جافا

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

بي أتش بي

لمزيد من المعلومات حول تثبيت عميل Cloud Firestore وإنشائه ، راجع مكتبات Cloud Firestore Client Libraries .

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

سويفت

ملاحظة: هذا المنتج غير متوفر في أهداف watchOS و App Clip.

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

ج موضوعية

ملاحظة: هذا المنتج غير متوفر في أهداف watchOS و 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

جافا

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

بي أتش بي

لمزيد من المعلومات حول تثبيت عميل Cloud Firestore وإنشائه ، راجع مكتبات Cloud Firestore Client Libraries .

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

سويفت

ملاحظة: هذا المنتج غير متوفر في أهداف watchOS و App Clip.

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

ج موضوعية

ملاحظة: هذا المنتج غير متوفر في أهداف watchOS و 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

جافا

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

بايثون

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

يذهب

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

بي أتش بي

لمزيد من المعلومات حول تثبيت عميل Cloud Firestore وإنشائه ، راجع مكتبات Cloud Firestore Client Libraries .

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

سويفت

ملاحظة: هذا المنتج غير متوفر في أهداف watchOS و App Clip.

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

ج موضوعية

ملاحظة: هذا المنتج غير متوفر في أهداف watchOS و 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

جافا

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

بايثون

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

Python

cities_ref = db.collection("cities")
query = cities_ref.where("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

بي أتش بي

لمزيد من المعلومات حول تثبيت عميل Cloud Firestore وإنشائه ، راجع مكتبات Cloud Firestore Client Libraries .

$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 في نفس المجال

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

سويفت

ملاحظة: هذا المنتج غير متوفر في أهداف watchOS و App Clip.

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

ج موضوعية

ملاحظة: هذا المنتج غير متوفر في أهداف watchOS و 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

جافا

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

بايثون

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

Python

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

Node.js

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

يذهب

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

بي أتش بي

لمزيد من المعلومات حول تثبيت عميل Cloud Firestore وإنشائه ، راجع مكتبات Cloud Firestore Client Libraries .

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

وحدة

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

سي #

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

روبي

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

غير صالح : نطاق التصفية orderBy الأول حسب الحقول المختلفة

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

سويفت

ملاحظة: هذا المنتج غير متوفر في أهداف watchOS و App Clip.

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

ج موضوعية

ملاحظة: هذا المنتج غير متوفر في أهداف watchOS و 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

جافا

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

بايثون

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

Python

cities_ref = db.collection("cities")
query = cities_ref.where("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

يذهب

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

بي أتش بي

لمزيد من المعلومات حول تثبيت عميل Cloud Firestore وإنشائه ، راجع مكتبات Cloud Firestore Client Libraries .

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

وحدة

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

سي #

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

روبي

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

لا يمكنك ترتيب استفسارك بأي حقل مضمن في المساواة ( = ) أو in البند.

`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”);