Cloud Firestore proporciona una potente función de consulta para especificar qué documentos deseas recuperar de una colección. Estas consultas también se pueden usar con get()
o addSnapshotListener()
, como se describe en cómo obtener datos.
Ordena y limita los datos
Según la configuración predeterminada, una consulta recupera todos los documentos que corresponden con la consulta en orden ascendente
por ID de documento. Puedes especificar el orden de clasificación para tus datos
mediante orderBy()
y, con limit()
, puedes limitar la cantidad de documentos
recuperados. Si especificas un limit()
, el valor debe ser mayor o igual
que cero.
Por ejemplo, puedes realizar una consulta que te muestre las primeras 3 ciudades en orden alfabético con:
import { query, orderBy, limit } from "firebase/firestore"; const q = query(citiesRef, orderBy("name"), limit(3));
citiesRef.orderBy("name").limit(3);
citiesRef.order(by: "name").limit(to: 3)
[[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);
cities_ref.OrderBy("name").Limit(3);
PHP
Para obtener más información sobre la instalación y creación de un cliente de Cloud Firestore, consulta Bibliotecas cliente de Cloud Firestore.
Query query = citiesRef.OrderBy("Name").Limit(3);
También puedes ordenar de forma descendente para ver las últimas 3 ciudades:
import { query, orderBy, limit } from "firebase/firestore"; const q = query(citiesRef, orderBy("name", "desc"), limit(3));
citiesRef.orderBy("name", "desc").limit(3);
citiesRef.order(by: "name", descending: true).limit(to: 3)
[[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);
cities_ref.OrderBy("name", Query::Direction::kDescending).Limit(3);
PHP
Para obtener más información sobre la instalación y creación de un cliente de Cloud Firestore, consulta Bibliotecas cliente de Cloud Firestore.
Query query = citiesRef.OrderByDescending("Name").Limit(3);
También puedes ordenar según varios campos. Por ejemplo, si quieres ordenar por estado y, dentro de cada estado, por población de manera descendente, usa este código:
import { query, orderBy } from "firebase/firestore"; const q = query(citiesRef, orderBy("state"), orderBy("population", "desc"));
citiesRef.orderBy("state").orderBy("population", "desc");
citiesRef .order(by: "state") .order(by: "population", descending: true)
[[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);
cities_ref.OrderBy("state").OrderBy("name", Query::Direction::kDescending);
PHP
Para obtener más información sobre la instalación y creación de un cliente de Cloud Firestore, consulta Bibliotecas cliente de Cloud Firestore.
Query query = citiesRef.OrderBy("State").OrderByDescending("Population");
Puedes combinar filtros where()
con orderBy()
y limit()
. En los
siguientes ejemplos, las consultas definen un umbral de población, clasifican por población
en orden ascendente y muestran solo los primeros resultados que superan el
umbral:
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);
citiesRef .whereField("population", isGreaterThan: 100000) .order(by: "population") .limit(to: 2)
[[[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);
cities_ref.WhereGreaterThan("population", FieldValue::Integer(100000)) .OrderBy("population") .Limit(2);
PHP
Para obtener más información sobre la instalación y creación de un cliente de Cloud Firestore, consulta Bibliotecas cliente de Cloud Firestore.
Query query = citiesRef .WhereGreaterThan("Population", 2500000) .OrderBy("Population") .Limit(2);
Sin embargo, si tienes un filtro con una comparación de rangos (<
, <=
, >
y >=
), el primer ordenamiento debe estar en el mismo campo. Consulta la lista de limitaciones de orderBy()
a continuación.
Limitaciones
Ten en cuenta la siguiente restricción para las cláusulas orderBy()
:
- Una cláusula
orderBy()
también filtra en busca de los campos especificados. El conjunto de resultados no incluirá documentos que no contengan los campos correspondientes.
orderBy
y existencia
Cuando ordenas una consulta por un campo determinado, esta puede mostrar solo los documentos en los que existe el campo order-by.
Por ejemplo, la siguiente consulta no mostraría ningún documento en el que el campo
population
no esté configurado, incluso si, de lo contrario, cumple con los filtros de consulta.
db.collection("cities").whereEqualTo("country", “USA”).orderBy(“population”);
Un efecto relacionado se aplica a las desigualdades. Una consulta con un filtro de desigualdad
en un campo también implica ordenar en ese campo. La siguiente
consulta no muestra documentos sin un campo population
, incluso
si country = USA
aparece en ese documento. Como solución alternativa, puedes ejecutar
consultas separadas para cada orden o asignar un valor a todos los campos
en los aplicas un orden.
db.collection(“cities”).where(or(“country”, USA”), greaterThan(“population”, 250000));
La consulta anterior incluye un order-by implícito sobre la desigualdad y es equivalente a lo siguiente:
db.collection(“cities”).where(or(“country”, USA”), greaterThan(“population”, 250000)).orderBy(“population”);