Cloud Firestore ile veri siparişi verme ve verileri sınırlama

Cloud Firestore, bir koleksiyondan hangi dokümanları almak istediğinizi belirtmek için güçlü bir sorgu işlevi sağlar. Bu sorgular, Veri Alma bölümünde açıklandığı gibi get() veya addSnapshotListener() ile de kullanılabilir.

Verileri sıralama ve sınırlama

Varsayılan olarak bir sorgu, sorguyu karşılayan tüm dokümanları doküman kimliğine göre artan düzende getirir. orderBy() parametresini kullanarak verilerinizin sıralama düzenini belirtebilir ve limit() parametresini kullanarak alınan doküman sayısını sınırlayabilirsiniz. limit() belirtirseniz değer sıfır veya sıfırdan büyük olmalıdır.

Örneğin, alfabetik olarak ilk 3 şehri şu şekilde sorgulayabilirsiniz:

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

const q = query(citiesRef, orderBy("name"), limit(3));
citiesRef.orderBy("name").limit(3);
Not: Bu ürün, watchOS ve App Clip hedeflerinde kullanılamaz.
citiesRef.order(by: "name").limit(to: 3)
Not: Bu ürün, watchOS ve App Clip hedeflerinde kullanılamaz.
[[citiesRef queryOrderedByField:@"name"] queryLimitedTo:3];
citiesRef.orderBy("name").limit(3)
citiesRef.orderBy("name").limit(3);
final citiesRef = db.collection("cities");
citiesRef.orderBy("name").limit(3);
Query query = cities.orderBy("name").limit(3);
Query query = cities.orderBy("name").limitToLast(3);
cities_ref = db.collection("cities")
query = cities_ref.order_by("name").limit_to_last(2)
results = query.get()
cities_ref = db.collection("cities")
query = cities_ref.order_by("name").limit_to_last(2)
results = await query.get()
cities_ref.OrderBy("name").Limit(3);
const firstThreeRes = await citiesRef.orderBy('name').limit(3).get();
query := cities.OrderBy("name", firestore.Asc).Limit(3)
query := cities.OrderBy("name", firestore.Asc).LimitToLast(3)

PHP

Cloud Firestore istemcisini yükleme ve oluşturma hakkında daha fazla bilgi için Cloud Firestore istemci kitaplıkları başlıklı makaleyi inceleyin.

$query = $citiesRef->orderBy('name')->limit(3);
Query query = citiesRef.OrderBy("Name").Limit(3);
Query query = citiesRef.OrderBy("Name").Limit(3);
query = cities_ref.order("name").limit(3)

Son 3 şehri görmek için azalan düzende de sıralayabilirsiniz:

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

const q = query(citiesRef, orderBy("name", "desc"), limit(3));
citiesRef.orderBy("name", "desc").limit(3);
Not: Bu ürün, watchOS ve App Clip hedeflerinde kullanılamaz.
citiesRef.order(by: "name", descending: true).limit(to: 3)
Not: Bu ürün, watchOS ve App Clip hedeflerinde kullanılamaz.
[[citiesRef queryOrderedByField:@"name" descending:YES] queryLimitedTo:3];
citiesRef.orderBy("name", Query.Direction.DESCENDING).limit(3)
citiesRef.orderBy("name", Direction.DESCENDING).limit(3);
final citiesRef = db.collection("cities");
citiesRef.orderBy("name", descending: true).limit(3);
Query query = cities.orderBy("name", Direction.DESCENDING).limit(3);
cities_ref = db.collection("cities")
query = cities_ref.order_by("name", direction=firestore.Query.DESCENDING).limit(3)
results = query.stream()
cities_ref = db.collection("cities")
query = cities_ref.order_by("name", direction=firestore.Query.DESCENDING).limit(3)
results = query.stream()
cities_ref.OrderBy("name", Query::Direction::kDescending).Limit(3);
const lastThreeRes = await citiesRef.orderBy('name', 'desc').limit(3).get();
query := cities.OrderBy("name", firestore.Desc).Limit(3)

PHP

Cloud Firestore istemcisini yükleme ve oluşturma hakkında daha fazla bilgi için Cloud Firestore istemci kitaplıkları başlıklı makaleyi inceleyin.

$query = $citiesRef->orderBy('name', 'DESC')->limit(3);
Query query = citiesRef.OrderByDescending("Name").Limit(3);
Query query = citiesRef.OrderByDescending("Name").Limit(3);
query = cities_ref.order("name", "desc").limit(3)

Ayrıca birden fazla alana göre de sıralama yapabilirsiniz. Örneğin, eyalete göre ve her eyalette nüfusa göre azalan düzende sıralama yapmak istiyorsanız:

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

const q = query(citiesRef, orderBy("state"), orderBy("population", "desc"));
citiesRef.orderBy("state").orderBy("population", "desc");
Not: Bu ürün, watchOS ve App Clip hedeflerinde kullanılamaz.
citiesRef
  .order(by: "state")
  .order(by: "population", descending: true)
Not: Bu ürün, watchOS ve App Clip hedeflerinde kullanılamaz.
[[citiesRef queryOrderedByField:@"state"] queryOrderedByField:@"population" descending:YES];
citiesRef.orderBy("state").orderBy("population", Query.Direction.DESCENDING)
citiesRef.orderBy("state").orderBy("population", Direction.DESCENDING);
final citiesRef = db.collection("cities");
citiesRef.orderBy("state").orderBy("population", descending: true);
Query query = cities.orderBy("state").orderBy("population", Direction.DESCENDING);
cities_ref = db.collection("cities")
ordered_city_ref = cities_ref.order_by("state").order_by(
    "population", direction=firestore.Query.DESCENDING
)
cities_ref = db.collection("cities")
cities_ref.order_by("state").order_by(
    "population", direction=firestore.Query.DESCENDING
)
cities_ref.OrderBy("state").OrderBy("name", Query::Direction::kDescending);
const byStateByPopRes = await citiesRef.orderBy('state').orderBy('population', 'desc').get();
query := client.Collection("cities").OrderBy("state", firestore.Asc).OrderBy("population", firestore.Desc)

PHP

Cloud Firestore istemcisini yükleme ve oluşturma hakkında daha fazla bilgi için Cloud Firestore istemci kitaplıkları başlıklı makaleyi inceleyin.

$query = $citiesRef->orderBy('state')->orderBy('population', 'DESC');
Query query = citiesRef.OrderBy("State").OrderByDescending("Population");
Query query = citiesRef.OrderBy("State").OrderByDescending("Population");
query = cities_ref.order("state").order("population", "desc")

where() filtrelerini orderBy() ve limit() ile birleştirebilirsiniz. Aşağıdaki örnekte sorgular bir popülasyon eşiği tanımlar, popülasyona göre artan düzende sıralar ve yalnızca eşiği aşan ilk birkaç sonucu döndürür:

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

const q = query(citiesRef, where("population", ">", 100000), orderBy("population"), limit(2));
citiesRef.where("population", ">", 100000).orderBy("population").limit(2);
Not: Bu ürün, watchOS ve App Clip hedeflerinde kullanılamaz.
citiesRef
  .whereField("population", isGreaterThan: 100000)
  .order(by: "population")
  .limit(to: 2)
Not: Bu ürün, watchOS ve App Clip hedeflerinde kullanılamaz.
[[[citiesRef queryWhereField:@"population" isGreaterThan:@100000]
    queryOrderedByField:@"population"]
    queryLimitedTo:2];
citiesRef.whereGreaterThan("population", 100000).orderBy("population").limit(2)
citiesRef.whereGreaterThan("population", 100000).orderBy("population").limit(2);
final citiesRef = db.collection("cities");
citiesRef
    .where("population", isGreaterThan: 100000)
    .orderBy("population")
    .limit(2);
Query query = cities.whereGreaterThan("population", 2500000L).orderBy("population").limit(2);
cities_ref = db.collection("cities")
query = (
    cities_ref.where(filter=FieldFilter("population", ">", 2500000))
    .order_by("population")
    .limit(2)
)
results = query.stream()
cities_ref = db.collection("cities")
query = (
    cities_ref.where(filter=FieldFilter("population", ">", 2500000))
    .order_by("population")
    .limit(2)
)
results = query.stream()
cities_ref.WhereGreaterThan("population", FieldValue::Integer(100000))
    .OrderBy("population")
    .Limit(2);
const biggestRes = await citiesRef.where('population', '>', 2500000)
  .orderBy('population').limit(2).get();
query := cities.Where("population", ">", 2500000).OrderBy("population", firestore.Desc).Limit(2)

PHP

Cloud Firestore istemcisini yükleme ve oluşturma hakkında daha fazla bilgi için Cloud Firestore istemci kitaplıkları başlıklı makaleyi inceleyin.

$query = $citiesRef
    ->where('population', '>', 2500000)
    ->orderBy('population')
    ->limit(2);
Query query = citiesRef
    .WhereGreaterThan("Population", 2500000)
    .OrderBy("Population")
    .Limit(2);
Query query = citiesRef
    .WhereGreaterThan("Population", 2500000)
    .OrderBy("Population")
    .Limit(2);
query = cities_ref.where("population", ">", 2_500_000).order("population").limit(2)

Ancak aralık karşılaştırması içeren bir filtreniz varsa (<, <=, >, >=) ilk sıralamanız aynı alanda olmalıdır. Aşağıdaki orderBy()sınırlamalarına göz atın.

Sınırlamalar

orderBy() yan tümceleri için aşağıdaki kısıtlamaya dikkat edin:

orderBy ve varlığı

Bir sorguyu belirli bir alana göre sıraladığınızda sorgu yalnızca sıralama alanına sahip belgeleri döndürebilir.

Örneğin, aşağıdaki sorgu, sorgu filtrelerini karşılıyor olsalar bile population alanının ayarlanmadığı dokümanları döndürmez.

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

Eşitsizlikler için de benzer bir etki geçerlidir. Bir alanda eşitsizlik filtresi içeren bir sorgu, söz konusu alana göre sıralama yapılmasını da ifade eder. Aşağıdaki sorgu, country = USA alanı olsa bile population alanı olmayan dokümanları döndürmez . Geçici bir çözüm olarak, her sıralama için ayrı sorgular yürütebilir veya sıralama yaptığınız tüm alanlara bir değer atayabilirsiniz.

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

Yukarıdaki sorgu, eşitsizlikte ima edilen bir sıralama içerir ve aşağıdakiyle eşdeğerdir:

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