Cloud Firestore proporciona una potente funcionalidad de consulta para especificar qué documentos desea recuperar de una colección. Estas consultas también se pueden usar con get()
o addSnapshotListener()
, como se describe en Obtener datos .
Ordenar y limitar datos
De forma predeterminada, una consulta recupera todos los documentos que satisfacen la consulta en orden ascendente por ID de documento. Puede especificar el orden de clasificación de sus datos usando orderBy()
y puede limitar la cantidad de documentos recuperados usando limit()
.
Por ejemplo, podría consultar las primeras 3 ciudades en orden alfabético con:
Web version 9
import { query, orderBy, limit } from "firebase/firestore"; const q = query(citiesRef, orderBy("name"), limit(3));
Web version 8
citiesRef.orderBy("name").limit(3);
Rápido
citiesRef.order(by: "name").limit(to: 3)
C objetivo
[[citiesRef queryOrderedByField:@"name"] queryLimitedTo:3];
Kotlin+KTX
citiesRef.orderBy("name").limit(3)
Java
citiesRef.orderBy("name").limit(3);
Dart
final citiesRef = db.collection("cities"); citiesRef.orderBy("name").limit(3);
Java
Pitón
Python
C++
cities_ref.OrderBy("name").Limit(3);
Nodo.js
Vamos
PHP
PHP
Para obtener más información sobre cómo instalar y crear un cliente de Cloud Firestore, consulte Bibliotecas de clientes de Cloud Firestore .
Unidad
Query query = citiesRef.OrderBy("Name").Limit(3);
C#
Rubí
También puede ordenar en orden descendente para obtener las últimas 3 ciudades:
Web version 9
import { query, orderBy, limit } from "firebase/firestore"; const q = query(citiesRef, orderBy("name", "desc"), limit(3));
Web version 8
citiesRef.orderBy("name", "desc").limit(3);
Rápido
citiesRef.order(by: "name", descending: true).limit(to: 3)
C objetivo
[[citiesRef queryOrderedByField:@"name" descending:YES] queryLimitedTo:3];
Kotlin+KTX
citiesRef.orderBy("name", Query.Direction.DESCENDING).limit(3)
Java
citiesRef.orderBy("name", Direction.DESCENDING).limit(3);
Dart
final citiesRef = db.collection("cities"); citiesRef.orderBy("name", descending: true).limit(3);
Java
Pitón
Python
C++
cities_ref.OrderBy("name", Query::Direction::kDescending).Limit(3);
Nodo.js
Vamos
PHP
PHP
Para obtener más información sobre cómo instalar y crear un cliente de Cloud Firestore, consulte Bibliotecas de clientes de Cloud Firestore .
Unidad
Query query = citiesRef.OrderByDescending("Name").Limit(3);
C#
Rubí
También puede ordenar por varios campos. Por ejemplo, si quisiera ordenar por estado, y dentro de cada estado ordenar por población en orden descendente:
Web version 9
import { query, orderBy } from "firebase/firestore"; const q = query(citiesRef, orderBy("state"), orderBy("population", "desc"));
Web version 8
citiesRef.orderBy("state").orderBy("population", "desc");
Rápido
citiesRef .order(by: "state") .order(by: "population", descending: true)
C objetivo
[[citiesRef queryOrderedByField:@"state"] queryOrderedByField:@"population" descending:YES];
Kotlin+KTX
citiesRef.orderBy("state").orderBy("population", Query.Direction.DESCENDING)
Java
citiesRef.orderBy("state").orderBy("population", Direction.DESCENDING);
Dart
final citiesRef = db.collection("cities"); citiesRef.orderBy("state").orderBy("population", descending: true);
Java
Pitón
Python
C++
cities_ref.OrderBy("state").OrderBy("name", Query::Direction::kDescending);
Nodo.js
Vamos
PHP
PHP
Para obtener más información sobre cómo instalar y crear un cliente de Cloud Firestore, consulte Bibliotecas de clientes de Cloud Firestore .
Unidad
Query query = citiesRef.OrderBy("State").OrderByDescending("Population");
C#
Rubí
Puede combinar los filtros where( where()
con orderBy()
y limit()
. En el siguiente ejemplo, las consultas definen un umbral de población, ordenan por población en orden ascendente y devuelven solo los primeros resultados que superan el umbral:
Web version 9
import { query, where, orderBy, limit } from "firebase/firestore"; const q = query(citiesRef, where("population", ">", 100000), orderBy("population"), limit(2));
Web version 8
citiesRef.where("population", ">", 100000).orderBy("population").limit(2);
Rápido
citiesRef .whereField("population", isGreaterThan: 100000) .order(by: "population") .limit(to: 2)
C objetivo
[[[citiesRef queryWhereField:@"population" isGreaterThan:@100000] queryOrderedByField:@"population"] queryLimitedTo:2];
Kotlin+KTX
citiesRef.whereGreaterThan("population", 100000).orderBy("population").limit(2)
Java
citiesRef.whereGreaterThan("population", 100000).orderBy("population").limit(2);
Dart
final citiesRef = db.collection("cities"); citiesRef .where("population", isGreaterThan: 100000) .orderBy("population") .limit(2);
Java
Pitón
Python
C++
cities_ref.WhereGreaterThan("population", FieldValue::Integer(100000)) .OrderBy("population") .Limit(2);
Nodo.js
Vamos
PHP
PHP
Para obtener más información sobre cómo instalar y crear un cliente de Cloud Firestore, consulte Bibliotecas de clientes de Cloud Firestore .
Unidad
Query query = citiesRef .WhereGreaterThan("Population", 2500000) .OrderBy("Population") .Limit(2);
C#
Rubí
Sin embargo, si tiene un filtro con una comparación de rango ( <
, <=
, >
, >=
), su primer pedido debe estar en el mismo campo, consulte la lista de limitaciones orderBy()
a continuación.
Limitaciones
Tenga en cuenta las siguientes restricciones para las cláusulas orderBy()
:
- Una cláusula
orderBy()
también filtra la existencia de los campos dados. El conjunto de resultados no incluirá documentos que no contengan los campos dados. Si incluye un filtro con una comparación de rango (
<
,<=
,>
,>=
), su primer pedido debe estar en el mismo campo:Válido : filtro de rango y
orderBy
en el mismo campoWeb version 9
import { query, where, orderBy } from "firebase/firestore"; const q = query(citiesRef, where("population", ">", 100000), orderBy("population"));
Web version 8
citiesRef.where("population", ">", 100000).orderBy("population");
Rápido
Nota: este producto no está disponible en los objetivos watchOS y App Clip.citiesRef .whereField("population", isGreaterThan: 100000) .order(by: "population")
C objetivo
Nota: este producto no está disponible en los objetivos watchOS y App Clip.[[citiesRef queryWhereField:@"population" isGreaterThan:@100000] queryOrderedByField:@"population"];
Kotlin+KTX
citiesRef.whereGreaterThan("population", 100000).orderBy("population")
Java
citiesRef.whereGreaterThan("population", 100000).orderBy("population");
Dart
final citiesRef = db.collection("cities"); citiesRef.where("population", isGreaterThan: 100000).orderBy("population");
Java
Query query = cities.whereGreaterThan("population", 2500000L).orderBy("population");
Pitón
Python
Nodo.js
Vamos
PHP
PHP
Para obtener más información sobre cómo instalar y crear un cliente de Cloud Firestore, consulte Bibliotecas de clientes de Cloud Firestore .
Unidad
Query query = citiesRef .WhereGreaterThan("Population", 2500000) .OrderBy("Population");
C#
Rubí
No válido : filtro de rango y primer
orderBy
por en diferentes camposWeb version 9
import { query, where, orderBy } from "firebase/firestore"; const q = query(citiesRef, where("population", ">", 100000), orderBy("country"));
Web version 8
citiesRef.where("population", ">", 100000).orderBy("country");
Rápido
Nota: este producto no está disponible en los objetivos watchOS y App Clip.citiesRef .whereField("population", isGreaterThan: 100000) .order(by: "country")
C objetivo
Nota: este producto no está disponible en los objetivos watchOS y App Clip.[[citiesRef queryWhereField:@"population" isGreaterThan:@100000] queryOrderedByField:@"country"];
Kotlin+KTX
citiesRef.whereGreaterThan("population", 100000).orderBy("country")
Java
citiesRef.whereGreaterThan("population", 100000).orderBy("country");
Dart
final citiesRef = db.collection("cities"); citiesRef.where("population", isGreaterThan: 100000).orderBy("country");
Java
Pitón
Python
C++
// BAD EXAMPLE -- will crash the program: cities_ref.WhereGreaterThan("population", FieldValue::Integer(100000)) .OrderBy("country");
Nodo.js
Vamos
PHP
PHP
Para obtener más información sobre cómo instalar y crear un cliente de Cloud Firestore, consulte Bibliotecas de clientes de Cloud Firestore .
Unidad
Query query = citiesRef .WhereGreaterThan("Population", 2500000) .OrderBy("Country");
C#
Rubí
- No puede ordenar su consulta por cualquier campo incluido en una cláusula de igualdad (
=
) oin
.