Esta página se ha traducido con Cloud Translation API.

Ordenar y limitar datos

Firestore ofrece una potente función de consulta para especificar los documentos que quieres recuperar de una colección. Estas consultas también se pueden usar con get() o addSnapshotListener(), tal como se describe en Obtener datos.

Ordenar y limitar datos

De forma predeterminada, una consulta recupera todos los documentos que la cumplen en orden ascendente por ID de documento. Puedes especificar el orden de los datos mediante orderBy() y limitar el número de documentos recuperados mediante limit(). Si especifica un limit(), el valor debe ser igual o superior a cero.

Por ejemplo, puedes consultar las tres primeras ciudades por orden alfabético con la siguiente consulta:

Versión web 9

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

const q = query(citiesRef, orderBy("name"), limit(3));order_and_limit.js

Versión web 8

citiesRef.orderBy("name").limit(3);test.firestore.js

Swift

Nota: Este producto no está disponible en los destinos de watchOS y App Clip.

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

Objective‑C

Nota: Este producto no está disponible en los destinos de watchOS y App Clip.

[[citiesRef queryOrderedByField:@"name"] queryLimitedTo:3];ViewController.m

Kotlin
Android

citiesRef.orderBy("name").limit(3)DocSnippets.kt

Java
Android

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
(Async)

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

Para autenticarte en Firestore, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación en un entorno de desarrollo local.

$query = $citiesRef->orderBy('name')->limit(3);

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

También puedes ordenar los resultados de forma descendente para obtener las últimas tres ciudades:

Versión web 9

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

const q = query(citiesRef, orderBy("name", "desc"), limit(3));order_and_limit_desc.js

Versión web 8

citiesRef.orderBy("name", "desc").limit(3);test.firestore.js

Swift

Nota: Este producto no está disponible en los destinos de watchOS y App Clip.

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

Objective‑C

Nota: Este producto no está disponible en los destinos de watchOS y App Clip.

[[citiesRef queryOrderedByField:@"name" descending:YES] queryLimitedTo:3];ViewController.m

Kotlin
Android

citiesRef.orderBy("name", Query.Direction.DESCENDING).limit(3)DocSnippets.kt

Java
Android

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
(Async)

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

$query = $citiesRef->orderBy('name', 'DESC')->limit(3);

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

También puedes ordenar los resultados por varios campos. Por ejemplo, si quieres ordenar por estado y, dentro de cada estado, por población en orden descendente, haz lo siguiente:

Versión web 9

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

const q = query(citiesRef, orderBy("state"), orderBy("population", "desc"));order_multiple.js

Versión web 8

citiesRef.orderBy("state").orderBy("population", "desc");test.firestore.js

Swift

Nota: Este producto no está disponible en los destinos de watchOS y App Clip.

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

Objective‑C

Nota: Este producto no está disponible en los destinos de watchOS y App Clip.

[[citiesRef queryOrderedByField:@"state"] queryOrderedByField:@"population" descending:YES];ViewController.m

Kotlin
Android

citiesRef.orderBy("state").orderBy("population", Query.Direction.DESCENDING)DocSnippets.kt

Java
Android

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
(Async)

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

$query = $citiesRef->orderBy('state')->orderBy('population', 'DESC');

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

Puedes combinar filtros de where() con orderBy() y limit(). En el siguiente ejemplo, las consultas definen un umbral de población, ordenan los resultados por población en orden ascendente y devuelven solo los primeros resultados que superan el umbral:

Versión web 9

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

const q = query(citiesRef, where("population", ">", 100000), orderBy("population"), limit(2));filter_and_order.js

Versión web 8

citiesRef.where("population", ">", 100000).orderBy("population").limit(2);test.firestore.js

Swift

Nota: Este producto no está disponible en los destinos de watchOS y App Clip.

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

Objective‑C

Nota: Este producto no está disponible en los destinos de watchOS y App Clip.

[[[citiesRef queryWhereField:@"population" isGreaterThan:@100000]
    queryOrderedByField:@"population"]
    queryLimitedTo:2];ViewController.m

Kotlin
Android

citiesRef.whereGreaterThan("population", 100000).orderBy("population").limit(2)DocSnippets.kt

Java
Android

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
(Async)

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

$query = $citiesRef
    ->where('population', '>', 2500000)
    ->orderBy('population')
    ->limit(2);

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

Sin embargo, si tiene un filtro con una comparación de intervalos (<, <=, >, >=), el primer orden debe ser del mismo campo. Consulte la lista de orderBy()limitaciones que se indica más abajo.

Limitaciones

Ten en cuenta la siguiente restricción para las cláusulas orderBy():

Una cláusula orderBy() también filtra por la existencia de los campos indicados. El conjunto de resultados no incluirá documentos que no contengan los campos indicados.

`orderBy` y existencia

Cuando ordenas una consulta por un campo determinado, la consulta solo puede devolver los documentos en los que exista el campo de ordenación.

Por ejemplo, la siguiente consulta no devolvería ningún documento en el que no se haya definido el campo population, aunque cumpla los filtros de la consulta.

Java

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

Se aplica un efecto similar a las desigualdades. Una consulta con un filtro de desigualdad en un campo también implica ordenar por ese campo. La siguiente consulta no devuelve documentos sin el campo population, aunque country = USA esté en ese documento . Como solución alternativa, puedes ejecutar consultas independientes para cada orden o asignar un valor a todos los campos por los que ordenes.

Java

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

La consulta anterior incluye una ordenación implícita por la desigualdad y es equivalente a la siguiente:

Java

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

Ordenar y limitar datos

Ordenar y limitar datos

Versión web 9

Versión web 8

Swift

Objective‑C

KotlinAndroid

JavaAndroid

Dart

Java

Python

Python(Async)

C++

Node.js

Go

PHP

PHP

Unity

C#

Ruby

Versión web 9

Versión web 8

Swift

Objective‑C

KotlinAndroid

JavaAndroid

Dart

Java

Python

Python(Async)

C++

Node.js

Go

PHP

PHP

Unity

C#

Ruby

Versión web 9

Versión web 8

Swift

Objective‑C

KotlinAndroid

JavaAndroid

Dart

Java

Python

Python(Async)

C++

Node.js

Go

PHP

PHP

Unity

C#

Ruby

Versión web 9

Versión web 8

Swift

Objective‑C

KotlinAndroid

JavaAndroid

Dart

Java

Python

Python(Async)

C++

Node.js

Go

PHP

PHP

Unity

C#

Ruby

Limitaciones

orderBy y existencia

Java

Java

Java

Kotlin
Android

Java
Android

Python
(Async)

Kotlin
Android

Java
Android

Python
(Async)

Kotlin
Android

Java
Android

Python
(Async)

Kotlin
Android

Java
Android

Python
(Async)

`orderBy` y existencia