Trier et limiter les données avec Cloud Firestore

Cloud Firestore propose une fonctionnalité de requête puissante qui vous permet de spécifier les documents que vous souhaitez récupérer dans une collection. Ces requêtes peuvent également être utilisées avec get() ou addSnapshotListener(), comme décrit dans la section Obtenir des données.

Trier et limiter les données

Par défaut, une requête récupère tous les documents qui y répondent dans l'ordre croissant par ID de document. Vous pouvez spécifier l'ordre dans lequel vous souhaitez trier vos données en utilisant orderBy(), et vous pouvez limiter le nombre de documents récupérés à l'aide de limit(). Si vous spécifiez un limit(), la valeur doit être supérieure ou égale à zéro.

Par exemple, vous pouvez effectuer une requête pour les trois premières villes par ordre alphabétique en indiquant :

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
Swift
Remarque : Ce produit n'est pas disponible sur les cibles watchOS et App Clip. 
citiesRef.order(by: "name").limit(to: 3)
ViewController.swift
Objective-C
Remarque : Ce produit n'est pas disponible sur les cibles watchOS et 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
Go
query := cities.OrderBy("name", firestore.Asc).Limit(3)
query := cities.OrderBy("name", firestore.Asc).LimitToLast(3)
query.go
PHP

PHP

Pour en savoir plus sur l'installation et la création d'un client Cloud Firestore, consultez la page Bibliothèques clientes Cloud Firestore. 

$query = $citiesRef->orderBy('name')->limit(3);
query_order_limit.php
Unity
Query query = citiesRef.OrderBy("Name").Limit(3);
C#
Query query = citiesRef.OrderBy("Name").Limit(3);
Program.cs
Ruby
query = cities_ref.order("name").limit(3)
order_limit_data.rb

Vous pouvez également trier par ordre décroissant pour obtenir les trois dernières villes :

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
Swift
Remarque : Ce produit n'est pas disponible sur les cibles watchOS et App Clip. 
citiesRef.order(by: "name", descending: true).limit(to: 3)
ViewController.swift
Objective-C
Remarque : Ce produit n'est pas disponible sur les cibles watchOS et 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
Go
query := cities.OrderBy("name", firestore.Desc).Limit(3)
query.go
PHP

PHP

Pour en savoir plus sur l'installation et la création d'un client Cloud Firestore, consultez la page Bibliothèques clientes Cloud Firestore. 

$query = $citiesRef->orderBy('name', 'DESC')->limit(3);
query_order_desc_limit.php
Unity
Query query = citiesRef.OrderByDescending("Name").Limit(3);
C#
Query query = citiesRef.OrderByDescending("Name").Limit(3);
Program.cs
Ruby
query = cities_ref.order("name", "desc").limit(3)
order_limit_data.rb

Vous pouvez également trier en utilisant plusieurs champs. Par exemple, si vous souhaitez trier par état, puis, dans chaque état, par ordre décroissant de population :

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
Swift
Remarque : Ce produit n'est pas disponible sur les cibles watchOS et App Clip. 
citiesRef
  .order(by: "state")
  .order(by: "population", descending: true)
ViewController.swift
Objective-C
Remarque : Ce produit n'est pas disponible sur les cibles watchOS et 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")
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
Go
query := client.Collection("cities").OrderBy("state", firestore.Asc).OrderBy("population", firestore.Desc)
query.go
PHP

PHP

Pour en savoir plus sur l'installation et la création d'un client Cloud Firestore, consultez la page Bibliothèques clientes Cloud Firestore. 

$query = $citiesRef->orderBy('state')->orderBy('population', 'DESC');
query_order_multi.php
Unity
Query query = citiesRef.OrderBy("State").OrderByDescending("Population");
C#
Query query = citiesRef.OrderBy("State").OrderByDescending("Population");
Program.cs
Ruby
query = cities_ref.order("state").order("population", "desc")
order_limit_data.rb

Vous pouvez combiner les filtres where() avec orderBy() et limit(). Dans l'exemple suivant, les requêtes définissent un seuil de population, trient par population par ordre croissant et ne renvoient que les premiers résultats qui dépassent le seuil :

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
Swift
Remarque : Ce produit n'est pas disponible sur les cibles watchOS et App Clip. 
citiesRef
  .whereField("population", isGreaterThan: 100000)
  .order(by: "population")
  .limit(to: 2)
ViewController.swift
Objective-C
Remarque : Ce produit n'est pas disponible sur les cibles watchOS et 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
Go
query := cities.Where("population", ">", 2500000).OrderBy("population", firestore.Desc).Limit(2)
query.go
PHP

PHP

Pour en savoir plus sur l'installation et la création d'un client Cloud Firestore, consultez la page Bibliothèques clientes Cloud Firestore. 

$query = $citiesRef
    ->where('population', '>', 2500000)
    ->orderBy('population')
    ->limit(2);
query_order_limit_field_valid.php
Unity
Query query = citiesRef
    .WhereGreaterThan("Population", 2500000)
    .OrderBy("Population")
    .Limit(2);
C#
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

Toutefois, si vous disposez d'un filtre avec une comparaison de plage (<, <=, >, >=), votre premier classement doit se trouver dans le même champ. Consultez la liste des limites orderBy() ci-dessous.

Limites

Notez la restriction suivante pour les clauses orderBy():

orderBy et existence

Lorsque vous triez une requête par un champ donné, elle ne peut renvoyer que les documents pour lesquels le champ de tri existe.

Par exemple, la requête suivante ne renverra aucun document pour lequel le champ population n'est pas défini, même s'ils répondent aux filtres de requête.

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

Un effet similaire s'applique aux inégalités. Une requête avec un filtre d'inégalité sur un champ implique également un tri par ce champ. La requête suivante ne renvoie pas de documents sans champ population, même si country = USA est présent dans ce document. Pour contourner ce problème, vous pouvez exécuter des requêtes distinctes pour chaque tri ou attribuer une valeur à tous les champs par lesquels vous triez.

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

La requête ci-dessus inclut un ordre implicite sur l'inégalité et est équivalente à la suivante :

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