O Cloud Firestore fornece funcionalidade de consulta poderosa para especificar quais documentos você deseja recuperar de uma coleção. Essas consultas também podem ser usadas com get()
ou addSnapshotListener()
, conforme descrito em Obter dados .
Dados de pedido e limite
Por padrão, uma consulta recupera todos os documentos que atendem à consulta em ordem crescente por ID do documento. Você pode especificar a ordem de classificação de seus dados usando orderBy()
e pode limitar o número de documentos recuperados usando limit()
.
Por exemplo, você pode consultar as 3 primeiras cidades em ordem alfabética com:
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)
Objective-C
[[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ão
Python
C++
cities_ref.OrderBy("name").Limit(3);
Node.js
Vai
PHP
PHP
Para saber mais sobre como instalar e criar um cliente Cloud Firestore, consulte Bibliotecas de cliente Cloud Firestore .
Unidade
Query query = citiesRef.OrderBy("Name").Limit(3);
C #
Rubi
Você também pode classificar em ordem decrescente para obter as últimas 3 cidades:
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)
Objective-C
[[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ão
Python
C++
cities_ref.OrderBy("name", Query::Direction::kDescending).Limit(3);
Node.js
Vai
PHP
PHP
Para saber mais sobre como instalar e criar um cliente Cloud Firestore, consulte Bibliotecas de cliente Cloud Firestore .
Unidade
Query query = citiesRef.OrderByDescending("Name").Limit(3);
C #
Rubi
Você também pode ordenar por vários campos. Por exemplo, se você quiser ordenar por estado, e dentro de cada estado ordenar por população em ordem decrescente:
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)
Objective-C
[[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ão
Python
C++
cities_ref.OrderBy("state").OrderBy("name", Query::Direction::kDescending);
Node.js
Vai
PHP
PHP
Para saber mais sobre como instalar e criar um cliente Cloud Firestore, consulte Bibliotecas de cliente Cloud Firestore .
Unidade
Query query = citiesRef.OrderBy("State").OrderByDescending("Population");
C #
Rubi
Você pode combinar filtros where( where()
com orderBy()
e limit()
. No exemplo a seguir, as consultas definem um limite de população, classificam por população em ordem crescente e retornam apenas os primeiros resultados que excedem o limite:
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)
Objective-C
[[[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ão
Python
C++
cities_ref.WhereGreaterThan("population", FieldValue::Integer(100000)) .OrderBy("population") .Limit(2);
Node.js
Vai
PHP
PHP
Para saber mais sobre como instalar e criar um cliente Cloud Firestore, consulte Bibliotecas de cliente Cloud Firestore .
Unidade
Query query = citiesRef .WhereGreaterThan("Population", 2500000) .OrderBy("Population") .Limit(2);
C #
Rubi
No entanto, se você tiver um filtro com uma comparação de intervalo ( <
, <=
, >
, >=
), sua primeira ordenação deve ser no mesmo campo, consulte a lista de limitações de orderBy()
abaixo.
Limitações
Observe as seguintes restrições para cláusulas orderBy()
:
- Uma cláusula
orderBy()
também filtra a existência dos campos fornecidos. O conjunto de resultados não incluirá documentos que não contenham os campos fornecidos. Se você incluir um filtro com uma comparação de intervalo (
<
,<=
,>
,>=
), sua primeira ordenação deverá estar no mesmo campo:Válido : filtro de intervalo e
orderBy
no mesmo 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
Observação: este produto não está disponível em destinos de watchOS e App Clip.citiesRef .whereField("population", isGreaterThan: 100000) .order(by: "population")
Objective-C
Observação: este produto não está disponível em destinos de watchOS e 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ão
Python
Node.js
Vai
PHP
PHP
Para saber mais sobre como instalar e criar um cliente Cloud Firestore, consulte Bibliotecas de cliente Cloud Firestore .
Unidade
Query query = citiesRef .WhereGreaterThan("Population", 2500000) .OrderBy("Population");
C #
Rubi
Inválido : Filtro de intervalo e primeiro
orderBy
em campos diferentesWeb 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
Observação: este produto não está disponível em destinos de watchOS e App Clip.citiesRef .whereField("population", isGreaterThan: 100000) .order(by: "country")
Objective-C
Observação: este produto não está disponível em destinos de watchOS e 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ão
Python
C++
// BAD EXAMPLE -- will crash the program: cities_ref.WhereGreaterThan("population", FieldValue::Integer(100000)) .OrderBy("country");
Node.js
Vai
PHP
PHP
Para saber mais sobre como instalar e criar um cliente Cloud Firestore, consulte Bibliotecas de cliente Cloud Firestore .
Unidade
Query query = citiesRef .WhereGreaterThan("Population", 2500000) .OrderBy("Country");
C #
Rubi
- Você não pode ordenar sua consulta por nenhum campo incluído em uma cláusula de igualdade (
=
) ouin
.