Daten sortieren und beschränken

Daten sortieren und beschränken

Firestore bietet leistungsstarke Abfragefunktionen, mit denen Sie festlegen können, welche Dokumente Sie aus einer Sammlung abrufen möchten. Diese Abfragen können auch mit get() oder addSnapshotListener() verwendet werden, wie unter Daten abrufen beschrieben.

Hinweis: Die Codebeispiele decken zwar mehrere Sprachen ab, der Erläuterungstext bezieht sich jedoch auf die Namen der Webmethoden.

Daten sortieren und beschränken

Standardmäßig ruft eine Abfrage alle Dokumente, die die Abfrage erfüllen, in aufsteigender Reihenfolge nach Dokument-ID ab. Sie können die Sortierreihenfolge für Ihre Daten mit orderBy() festlegen und die Anzahl der abgerufenen Dokumente mit limit() begrenzen. Wenn Sie limit() angeben, muss der Wert größer oder gleich null sein.

Hinweis: Eine orderBy()-Klausel filtert auch das Vorhandensein des angegebenen Felds. Die Ergebnismenge enthält keine Dokumente, die das angegebene Feld nicht enthalten.

So können Sie beispielsweise die ersten 3 Städte nach dem Alphabet abfragen:

Webversion 9

Weitere Informationen zur modularen Web API, die durch Tree-Shaking optimiert werden kann, und zum Upgrade von der API mit Namensraum.

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

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

Webversion 8

Informationen zur baumrüttbaren modularen Web API und Upgrade von die Namespace-API.

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

Swift

Hinweis: Dieses Produkt nicht ist auf WatchOS- und App Clip-Zielen verfügbar.

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

Objective-C

Hinweis: Dieses Produkt nicht ist auf WatchOS- und App Clip-Zielen verfügbar.

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

Kotlin+KTX
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

PHP

Richten Sie Standardanmeldedaten für Anwendungen ein, um sich bei Firestore zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.

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

Einheit

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

Sie können auch in absteigender Reihenfolge sortieren, um die letzten 3 Städte abzurufen:

Webversion 9

Informationen zur baumrüttbaren modularen Web API und Upgrade von die Namespace-API.

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

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

Webversion 8

Informationen zur baumrüttbaren modularen Web API und Upgrade von die Namespace-API.

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

Swift

Hinweis: Dieses Produkt nicht ist auf WatchOS- und App Clip-Zielen verfügbar.

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

Objective-C

Hinweis: Dieses Produkt nicht ist auf WatchOS- und App Clip-Zielen verfügbar.

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

Kotlin+KTX
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

PHP

Richten Sie Standardanmeldedaten für Anwendungen ein, um sich bei Firestore zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.

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

Einheit

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

Sie können auch nach mehreren Feldern sortieren. Wenn Sie zum Beispiel nach Bundesland und innerhalb jedes Bundeslands in absteigender Reihenfolge nach Bevölkerungszahl sortieren möchten, gehen Sie so vor:

Webversion 9

Informationen zur baumrüttbaren modularen Web API und Upgrade von die Namespace-API.

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

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

Webversion 8

Informationen zur baumrüttbaren modularen Web API und Upgrade von die Namespace-API.

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

Swift

Hinweis: Dieses Produkt nicht ist auf WatchOS- und App Clip-Zielen verfügbar.

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

Objective-C

Hinweis: Dieses Produkt nicht ist auf WatchOS- und App Clip-Zielen verfügbar.

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

Kotlin+KTX
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

PHP

Richten Sie Standardanmeldedaten für Anwendungen ein, um sich bei Firestore zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.

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

Einheit

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

Sie können where()-Filter mit orderBy() und limit() kombinieren. Die Abfragen im folgenden Beispiel definieren einen Bevölkerungsgrenzwert, sortieren in aufsteigender Reihenfolge nach Bevölkerungszahl und geben nur die ersten Ergebnisse zurück, die den Grenzwert überschreiten:

Webversion 9

Informationen zur baumrüttbaren modularen Web API und Upgrade von die Namespace-API.

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

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

Webversion 8

Weitere Informationen zur modularen Web API, die durch Tree-Shaking optimiert werden kann, und zum Upgrade von der API mit Namensraum.

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

Swift

Hinweis: Dieses Produkt nicht ist auf WatchOS- und App Clip-Zielen verfügbar.

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

Objective-C

Hinweis: Dieses Produkt nicht ist auf WatchOS- und App Clip-Zielen verfügbar.

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

Kotlin+KTX
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

PHP

Richten Sie Standardanmeldedaten für Anwendungen ein, um sich bei Firestore zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.

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

Einheit

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

Bei einem Filter mit einem Bereichsvergleich (<, <=, >, >=) muss sich Ihre erste Sortierung jedoch auf dasselbe Feld beziehen. Siehe dazu auch die folgende Liste von Beschränkungen für orderBy().

Beschränkungen

Beachten Sie die folgende Einschränkung für orderBy()-Klauseln:

• Eine orderBy()-Klausel filtert auch das Vorhandensein der angegebenen Felder. Das Ergebnis enthält keine Dokumente, die die angegebenen Felder nicht enthalten.

orderBy und Existenz

Wenn Sie eine Abfrage nach einem bestimmten Feld sortieren, kann die Abfrage nur das Element Dokumente, in denen das Feld „Sortieren nach“ vorhanden ist.

Die folgende Abfrage würde beispielsweise keine Dokumente zurückgeben, in denen der Das Feld population ist nicht festgelegt, auch wenn die Filter ansonsten den Abfragefiltern entsprechen.

Java

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

Ein damit verbundener Effekt bezieht sich auf Ungleichungen. Eine Abfrage mit einem Ungleichheitsfilter für ein Feld impliziert auch eine Sortierung nach diesem Feld. Die folgenden gibt die Abfrage keine Dokumente ohne population-Feld zurück, auch nicht wenn country = USA in diesem Dokument . Als Behelfslösung können Sie separate Abfragen für jede Reihenfolge oder Sie können einen Wert für alle Felder zuweisen. nach dem Sie sortieren.

Java

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

Die obige Abfrage enthält eine implizite Sortierung nach der Ungleichheit und entspricht der folgenden Abfrage:

Java

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