本頁面由 Cloud Translation API 翻譯而成。

檢索數據

本文檔介紹了檢索數據庫數據的基礎知識、數據的排序方式以及如何對數據執行簡單查詢。 Admin SDK 中的數據檢索在不同編程語言中的實現略有不同。

異步偵聽器：通過將異步偵聽器附加到數據庫引用來檢索存儲在 Firebase 實時數據庫中的數據。偵聽器針對數據的初始狀態觸發一次，並在數據更改時再次觸發。一個事件偵聽器可能會收到幾種不同類型的事件。 Java、Node.js 和 Python Admin SDK 支持這種數據檢索模式。
阻塞讀取：通過對數據庫引用調用阻塞方法來檢索存儲在 Firebase 實時數據庫中的數據，該方法返回存儲在引用中的數據。每個方法調用都是一次性操作。這意味著 SDK 不會註冊任何監聽後續數據更新的回調。 Python 和 Go Admin SDK 支持這種數據檢索模型。

入門

讓我們重溫上一篇文章中的博客示例，了解如何從 Firebase 數據庫讀取數據。回想一下示例應用程序中的博客文章存儲在數據庫 URL https://docs-examples.firebaseio.com/server/saving-data/fireblog/posts.json中。要讀取您的帖子數據，您可以執行以下操作：

爪哇

public static class Post {

  public String author;
  public String title;

  public Post(String author, String title) {
    // ...
  }

}

// Get a reference to our posts
final FirebaseDatabase database = FirebaseDatabase.getInstance();
DatabaseReference ref = database.getReference("server/saving-data/fireblog/posts");

// Attach a listener to read the data at our posts reference
ref.addValueEventListener(new ValueEventListener() {
  @Override
  public void onDataChange(DataSnapshot dataSnapshot) {
    Post post = dataSnapshot.getValue(Post.class);
    System.out.println(post);
  }

  @Override
  public void onCancelled(DatabaseError databaseError) {
    System.out.println("The read failed: " + databaseError.getCode());
  }
});

節點.js

// Get a database reference to our posts
const db = getDatabase();
const ref = db.ref('server/saving-data/fireblog/posts');

// Attach an asynchronous callback to read the data at our posts reference
ref.on('value', (snapshot) => {
  console.log(snapshot.val());
}, (errorObject) => {
  console.log('The read failed: ' + errorObject.name);
});

Python

# Import database module.
from firebase_admin import db

# Get a database reference to our posts
ref = db.reference('server/saving-data/fireblog/posts')

# Read the data at the posts reference (this is a blocking operation)
print(ref.get())

去


// Post is a json-serializable type.
type Post struct {
	Author string `json:"author,omitempty"`
	Title  string `json:"title,omitempty"`
}

// Create a database client from App.
client, err := app.Database(ctx)
if err != nil {
	log.Fatalln("Error initializing database client:", err)
}

// Get a database reference to our posts
ref := client.NewRef("server/saving-data/fireblog/posts")

// Read the data at the posts reference (this is a blocking operation)
var post Post
if err := ref.Get(ctx, &post); err != nil {
	log.Fatalln("Error reading value:", err)
}

在 Java 和 Node.js 中，您可以將可選的取消回調傳遞給事件訂閱，如果讀取被取消，該回調將被調用。如果應用程序客戶端沒有從該數據庫引用中讀取的權限，則讀取將被取消。此回調傳遞了一個error對象，指示失敗發生的原因。在 Python 和 Go 中， get() / Get()操作會因在出現錯誤時引發異常而失敗。

如果運行上面的代碼，您將看到一個對象，其中包含您記錄到控制台的所有帖子。在 Node.js 和 Java 的情況下，每當新數據添加到您的數據庫引用時都會調用偵聽器函數，並且您不需要編寫任何額外的代碼來實現這一點。

在 Java 和 Node.js 中，回調函數接收一個DataSnapshot ，它是數據的快照。快照是單個時間點特定數據庫引用處的數據圖片。在快照上調用val() / getValue()返回數據的特定語言對象表示。如果引用位置不存在數據，則快照的值為null 。 Python 中的get()方法直接返回數據的 Python 表示形式。 Go 中的Get()函數將數據解組為給定的數據結構。

請注意，我們在上面的示例中使用了value事件類型，它讀取 Firebase 數據庫引用的全部內容，即使只有一條數據發生變化。 value是下面列出的五種不同事件類型之一，您可以使用它們從數據庫中讀取數據。

閱讀 Java 和 Node.js 中的事件類型

價值

value事件用於讀取給定數據庫路徑中內容的靜態快照，因為它們在讀取事件發生時存在。它使用初始數據觸發一次，每次數據更改時再次觸發。向事件回調傳遞一個快照，其中包含該位置的所有數據，包括子數據。在上面的代碼示例中， value返回了您應用中的所有博客文章。每次添加新博文時，回調函數將返回所有博文。

已添加孩子

child_added事件通常在從數據庫中檢索項目列表時使用。與返回位置的全部內容的value不同， child_added為每個現有子項觸發一次，然後在每次將新子項添加到指定路徑時再次觸發。向事件回調傳遞包含新孩子數據的快照。出於排序目的，它還傳遞了第二個參數，其中包含前一個孩子的鍵。

如果您只想檢索添加到您的博客應用程序的每個新帖子的數據，您可以使用child_added ：

爪哇

ref.addChildEventListener(new ChildEventListener() {
  @Override
  public void onChildAdded(DataSnapshot dataSnapshot, String prevChildKey) {
    Post newPost = dataSnapshot.getValue(Post.class);
    System.out.println("Author: " + newPost.author);
    System.out.println("Title: " + newPost.title);
    System.out.println("Previous Post ID: " + prevChildKey);
  }

  @Override
  public void onChildChanged(DataSnapshot dataSnapshot, String prevChildKey) {}

  @Override
  public void onChildRemoved(DataSnapshot dataSnapshot) {}

  @Override
  public void onChildMoved(DataSnapshot dataSnapshot, String prevChildKey) {}

  @Override
  public void onCancelled(DatabaseError databaseError) {}
});

節點.js

// Retrieve new posts as they are added to our database
ref.on('child_added', (snapshot, prevChildKey) => {
  const newPost = snapshot.val();
  console.log('Author: ' + newPost.author);
  console.log('Title: ' + newPost.title);
  console.log('Previous Post ID: ' + prevChildKey);
});

在此示例中，快照將包含一個帶有單獨博客文章的對象。由於 SDK 通過檢索值將帖子轉換為對象，因此您可以通過分別調用author和title來訪問帖子的 author 和 title 屬性。您還可以從第二個prevChildKey參數訪問之前的帖子 ID。

孩子變了

child_changed事件在子節點被修改時被觸發。這包括對子節點後代的任何修改。它通常與child_added和child_removed結合使用以響應對項目列表的更改。傳遞給事件回調的快照包含子項的更新數據。

您可以使用child_changed在編輯博客文章時讀取更新的數據：

爪哇

ref.addChildEventListener(new ChildEventListener() {
  @Override
  public void onChildAdded(DataSnapshot dataSnapshot, String prevChildKey) {}

  @Override
  public void onChildChanged(DataSnapshot dataSnapshot, String prevChildKey) {
    Post changedPost = dataSnapshot.getValue(Post.class);
    System.out.println("The updated post title is: " + changedPost.title);
  }

  @Override
  public void onChildRemoved(DataSnapshot dataSnapshot) {}

  @Override
  public void onChildMoved(DataSnapshot dataSnapshot, String prevChildKey) {}

  @Override
  public void onCancelled(DatabaseError databaseError) {}
});

節點.js

// Get the data on a post that has changed
ref.on('child_changed', (snapshot) => {
  const changedPost = snapshot.val();
  console.log('The updated post title is ' + changedPost.title);
});

孩子被移除

child_removed事件在刪除直接子項時觸發。它通常與child_added和child_changed結合使用。傳遞給事件回調的快照包含已刪除子項的數據。

在博客示例中，您可以使用child_removed將有關已刪除帖子的通知記錄到控制台：

爪哇

ref.addChildEventListener(new ChildEventListener() {
  @Override
  public void onChildAdded(DataSnapshot dataSnapshot, String prevChildKey) {}

  @Override
  public void onChildChanged(DataSnapshot dataSnapshot, String prevChildKey) {}

  @Override
  public void onChildRemoved(DataSnapshot dataSnapshot) {
    Post removedPost = dataSnapshot.getValue(Post.class);
    System.out.println("The blog post titled " + removedPost.title + " has been deleted");
  }

  @Override
  public void onChildMoved(DataSnapshot dataSnapshot, String prevChildKey) {}

  @Override
  public void onCancelled(DatabaseError databaseError) {}
});

節點.js

// Get a reference to our posts
const ref = db.ref('server/saving-data/fireblog/posts');

// Get the data on a post that has been removed
ref.on('child_removed', (snapshot) => {
  const deletedPost = snapshot.val();
  console.log('The blog post titled \'' + deletedPost.title + '\' has been deleted');
});

孩子搬家

child_moved事件在處理有序數據時使用，這將在下一節中介紹。

活動保證

Firebase 數據庫對事件做出了幾個重要的保證：

數據庫事件保證
當本地狀態發生變化時，事件將始終被觸發。
事件最終將始終反映數據的正確狀態，即使在本地操作或時間導致暫時差異的情況下，例如網絡連接暫時丟失。
來自單個客戶端的寫入將始終寫入服務器並按順序廣播給其他用戶。
值事件總是最後觸發，並保證包含在拍攝快照之前發生的任何其他事件的更新。

由於值事件總是最後觸發，下面的例子總是有效的：

爪哇

final AtomicInteger count = new AtomicInteger();

ref.addChildEventListener(new ChildEventListener() {
  @Override
  public void onChildAdded(DataSnapshot dataSnapshot, String prevChildKey) {
    // New child added, increment count
    int newCount = count.incrementAndGet();
    System.out.println("Added " + dataSnapshot.getKey() + ", count is " + newCount);
  }

  // ...
});

// The number of children will always be equal to 'count' since the value of
// the dataSnapshot here will include every child_added event triggered before this point.
ref.addListenerForSingleValueEvent(new ValueEventListener() {
  @Override
  public void onDataChange(DataSnapshot dataSnapshot) {
    long numChildren = dataSnapshot.getChildrenCount();
    System.out.println(count.get() + " == " + numChildren);
  }

  @Override
  public void onCancelled(DatabaseError databaseError) {}
});

節點.js

let count = 0;

ref.on('child_added', (snap) => {
  count++;
  console.log('added:', snap.key);
});

// length will always equal count, since snap.val() will include every child_added event
// triggered before this point
ref.once('value', (snap) => {
  console.log('initial data loaded!', snap.numChildren() === count);
});

分離回調

通過指定事件類型和要刪除的回調函數來刪除回調，如下所示：

爪哇

// Create and attach listener
ValueEventListener listener = new ValueEventListener() {
    // ...
};
ref.addValueEventListener(listener);

// Remove listener
ref.removeEventListener(listener);

節點.js

ref.off('value', originalCallback);

如果將範圍上下文傳遞給on() ，則在分離回調時必須傳遞它：

爪哇

// Not applicable for Java

節點.js

ref.off('value', originalCallback, ctx);

如果您想刪除某個位置的所有回調，您可以執行以下操作：

爪哇

// No Java equivalent, listeners must be removed individually.

節點.js

// Remove all value callbacks
ref.off('value');

// Remove all callbacks of any type
ref.off();

一次讀取數據

在某些情況下，回調被調用一次然後立即刪除可能很有用。我們創建了一個輔助函數來簡化此操作：

爪哇

ref.addListenerForSingleValueEvent(new ValueEventListener() {
  @Override
  public void onDataChange(DataSnapshot dataSnapshot) {
    // ...
  }

  @Override
  public void onCancelled(DatabaseError databaseError) {
    // ...
  }
});

節點.js

ref.once('value', (data) => {
  // do some stuff once
});

Python

# Import database module.
from firebase_admin import db

# Get a database reference to our posts
ref = db.reference('server/saving-data/fireblog/posts')

# Read the data at the posts reference (this is a blocking operation)
print(ref.get())

去

// Create a database client from App.
client, err := app.Database(ctx)
if err != nil {
	log.Fatalln("Error initializing database client:", err)
}

// Get a database reference to our posts
ref := client.NewRef("server/saving-data/fireblog/posts")

// Read the data at the posts reference (this is a blocking operation)
var post Post
if err := ref.Get(ctx, &post); err != nil {
	log.Fatalln("Error reading value:", err)
}

查詢數據

使用 Firebase 數據庫查詢，您可以根據各種因素有選擇地檢索數據。要在數據庫中構建查詢，您首先要使用以下排序函數之一指定您希望如何對數據進行排序： orderByChild() 、 orderByKey()或orderByValue() 。然後，您可以將這些方法與其他五種方法結合起來進行複雜查詢： limitToFirst() 、 limitToLast() 、 startAt() 、 endAt()和equalTo() 。

由於我們 Firebase 的所有人都認為恐龍很酷，我們將使用來自恐龍事實示例數據庫的片段來演示如何在 Firebase 數據庫中查詢數據。：

{
  "lambeosaurus": {
    "height" : 2.1,
    "length" : 12.5,
    "weight": 5000
  },
  "stegosaurus": {
    "height" : 4,
    "length" : 9,
    "weight" : 2500
  }
}

您可以通過三種方式對數據進行排序：按子鍵、按鍵或按值。基本的數據庫查詢從這些排序函數之一開始，下面對每個函數進行了解釋。

按指定子鍵排序

您可以通過將該鍵傳遞給orderByChild()來按公共子鍵對節點進行排序。例如，要讀取所有按高度排序的恐龍，您可以執行以下操作：

爪哇

public static class Dinosaur {

  public int height;
  public int weight;

  public Dinosaur(int height, int weight) {
    // ...
  }

}

final DatabaseReference dinosaursRef = database.getReference("dinosaurs");
dinosaursRef.orderByChild("height").addChildEventListener(new ChildEventListener() {
  @Override
  public void onChildAdded(DataSnapshot dataSnapshot, String prevChildKey) {
    Dinosaur dinosaur = dataSnapshot.getValue(Dinosaur.class);
    System.out.println(dataSnapshot.getKey() + " was " + dinosaur.height + " meters tall.");
  }

  // ...
});

節點.js

const ref = db.ref('dinosaurs');

ref.orderByChild('height').on('child_added', (snapshot) => {
  console.log(snapshot.key + ' was ' + snapshot.val().height + ' meters tall');
});

Python

ref = db.reference('dinosaurs')
snapshot = ref.order_by_child('height').get()
for key, val in snapshot.items():
    print('{0} was {1} meters tall'.format(key, val))

去


// Dinosaur is a json-serializable type.
type Dinosaur struct {
	Height int `json:"height"`
	Width  int `json:"width"`
}

ref := client.NewRef("dinosaurs")

results, err := ref.OrderByChild("height").GetOrdered(ctx)
if err != nil {
	log.Fatalln("Error querying database:", err)
}
for _, r := range results {
	var d Dinosaur
	if err := r.Unmarshal(&d); err != nil {
		log.Fatalln("Error unmarshaling result:", err)
	}
	fmt.Printf("%s was %d meteres tall", r.Key(), d.Height)
}

任何沒有我們正在查詢的子鍵的節點都使用null值進行排序，這意味著它將在排序中排在第一位。有關數據排序方式的詳細信息，請參閱數據排序方式部分。

查詢也可以由嵌套很深的孩子排序，而不僅僅是下一級的孩子。如果您有像這樣的深度嵌套數據，這將很有用：

{
  "lambeosaurus": {
    "dimensions": {
      "height" : 2.1,
      "length" : 12.5,
      "weight": 5000
    }
  },
  "stegosaurus": {
    "dimensions": {
      "height" : 4,
      "length" : 9,
      "weight" : 2500
    }
  }
}

現在要查詢高度，您可以使用對象的完整路徑而不是單個鍵：

爪哇

dinosaursRef.orderByChild("dimensions/height").addChildEventListener(new ChildEventListener() {
  @Override
  public void onChildAdded(DataSnapshot dataSnapshot, String prevChildKey) {
    // ...
  }

  // ...
});

節點.js

const ref = db.ref('dinosaurs');
ref.orderByChild('dimensions/height').on('child_added', (snapshot) => {
  console.log(snapshot.key + ' was ' + snapshot.val().height + ' meters tall');
});

Python

ref = db.reference('dinosaurs')
snapshot = ref.order_by_child('dimensions/height').get()
for key, val in snapshot.items():
    print('{0} was {1} meters tall'.format(key, val))

去

ref := client.NewRef("dinosaurs")

results, err := ref.OrderByChild("dimensions/height").GetOrdered(ctx)
if err != nil {
	log.Fatalln("Error querying database:", err)
}
for _, r := range results {
	var d Dinosaur
	if err := r.Unmarshal(&d); err != nil {
		log.Fatalln("Error unmarshaling result:", err)
	}
	fmt.Printf("%s was %d meteres tall", r.Key(), d.Height)
}

查詢一次只能按一個鍵排序。對同一查詢多次調用orderByChild()會引發錯誤。

按鍵訂購

您還可以使用orderByKey()方法按鍵對節點進行排序。以下示例按字母順序讀取所有恐龍：

爪哇

dinosaursRef.orderByKey().addChildEventListener(new ChildEventListener() {
  @Override
  public void onChildAdded(DataSnapshot dataSnapshot, String prevChildKey) {
    System.out.println(dataSnapshot.getKey());
  }

  // ...
});

節點.js

var ref = db.ref('dinosaurs');
ref.orderByKey().on('child_added', (snapshot) => {
  console.log(snapshot.key);
});

Python

ref = db.reference('dinosaurs')
snapshot = ref.order_by_key().get()
print(snapshot)

去

ref := client.NewRef("dinosaurs")

results, err := ref.OrderByKey().GetOrdered(ctx)
if err != nil {
	log.Fatalln("Error querying database:", err)
}
snapshot := make([]Dinosaur, len(results))
for i, r := range results {
	var d Dinosaur
	if err := r.Unmarshal(&d); err != nil {
		log.Fatalln("Error unmarshaling result:", err)
	}
	snapshot[i] = d
}
fmt.Println(snapshot)

按值排序

您可以使用orderByValue()方法按節點的子鍵值對節點進行排序。假設恐龍正在舉行一場恐龍運動比賽，而您正在按照以下格式跟踪他們的分數：

{
  "scores": {
    "bruhathkayosaurus" : 55,
    "lambeosaurus" : 21,
    "linhenykus" : 80,
    "pterodactyl" : 93,
    "stegosaurus" : 5,
    "triceratops" : 22
  }
}

要按分數對恐龍進行排序，您可以構建以下查詢：

爪哇

DatabaseReference scoresRef = database.getReference("scores");
scoresRef.orderByValue().addChildEventListener(new ChildEventListener() {
  @Override
  public void onChildAdded(DataSnapshot dataSnapshot, String prevChildKey) {
    System.out.println("The " + dataSnapshot.getKey() + " score is " + dataSnapshot.getValue());
  }

  // ...
});

節點.js

const scoresRef = db.ref('scores');
scoresRef.orderByValue().on('value', (snapshot) => {
  snapshot.forEach((data) => {
    console.log('The ' + data.key + ' dinosaur\'s score is ' + data.val());
  });
});

Python

ref = db.reference('scores')
snapshot = ref.order_by_value().get()
for key, val in snapshot.items():
    print('The {0} dinosaur\'s score is {1}'.format(key, val))

去

ref := client.NewRef("scores")

results, err := ref.OrderByValue().GetOrdered(ctx)
if err != nil {
	log.Fatalln("Error querying database:", err)
}
for _, r := range results {
	var score int
	if err := r.Unmarshal(&score); err != nil {
		log.Fatalln("Error unmarshaling result:", err)
	}
	fmt.Printf("The %s dinosaur's score is %d\n", r.Key(), score)
}

有關使用orderByValue()時如何對null 、布爾值、字符串和對象值進行排序的說明，請參閱數據的排序方式部分。

複雜查詢

現在您的數據是如何排序的已經很清楚了，您可以使用下面描述的限製或範圍方法來構造更複雜的查詢。

限制查詢

limitToFirst()和limitToLast()查詢用於設置要為給定回調同步的最大子級數。如果將限制設置為 100，則最初最多只能接收 100 個child_added事件。如果您的數據庫中存儲的消息少於 100 條，則將為每條消息觸發一個child_added事件。但是，如果您有超過 100 條消息，您將只會收到其中 100 條消息的child_added事件。如果您使用limitToFirst()則這些是前 100 條有序消息；如果您使用limitToLast() ，則這些是最後 100 條有序消息。隨著項目的變化，您將收到進入查詢的項目的child_added事件和離開查詢的項目的child_removed事件，因此總數保持在 100。

使用恐龍事實數據庫和orderByChild() ，您可以找到兩種最重的恐龍：

爪哇

dinosaursRef.orderByChild("weight").limitToLast(2).addChildEventListener(new ChildEventListener() {
  @Override
  public void onChildAdded(DataSnapshot dataSnapshot, String prevChildKey) {
    System.out.println(dataSnapshot.getKey());
  }

  // ...
});

節點.js

const ref = db.ref('dinosaurs');
ref.orderByChild('weight').limitToLast(2).on('child_added', (snapshot) => {
  console.log(snapshot.key);
});

Python

ref = db.reference('dinosaurs')
snapshot = ref.order_by_child('weight').limit_to_last(2).get()
for key in snapshot:
    print(key)

去

ref := client.NewRef("dinosaurs")

results, err := ref.OrderByChild("weight").LimitToLast(2).GetOrdered(ctx)
if err != nil {
	log.Fatalln("Error querying database:", err)
}
for _, r := range results {
	fmt.Println(r.Key())
}

child_added回調恰好被觸發兩次，除非數據庫中存儲的恐龍少於兩隻。對於每一個添加到數據庫中的新的、更重的恐龍，它也會被觸發。在 Python 中，查詢直接返回包含兩個最重恐龍的OrderedDict 。

同樣，您可以使用limitToFirst()找到兩隻最矮的恐龍：

爪哇

dinosaursRef.orderByChild("weight").limitToFirst(2).addChildEventListener(new ChildEventListener() {
  @Override
  public void onChildAdded(DataSnapshot dataSnapshot, String prevChildKey) {
    System.out.println(dataSnapshot.getKey());
  }

  // ...
});

節點.js

const ref = db.ref('dinosaurs');
ref.orderByChild('height').limitToFirst(2).on('child_added', (snapshot) => {
  console.log(snapshot.key);
});

Python

ref = db.reference('dinosaurs')
snapshot = ref.order_by_child('height').limit_to_first(2).get()
for key in snapshot:
    print(key)

去

ref := client.NewRef("dinosaurs")

results, err := ref.OrderByChild("height").LimitToFirst(2).GetOrdered(ctx)
if err != nil {
	log.Fatalln("Error querying database:", err)
}
for _, r := range results {
	fmt.Println(r.Key())
}

child_added回調恰好被觸發兩次，除非數據庫中存儲的恐龍少於兩隻。如果從數據庫中刪除前兩隻恐龍中的一隻，它也會再次被觸發，因為新的恐龍現在將是第二矮的。在 Python 中，查詢直接返回一個包含最矮恐龍的OrderedDict 。

您還可以使用orderByValue()進行限制查詢。如果你想創建一個包含前 3 名得分最高的恐龍運動恐龍的排行榜，你可以執行以下操作：

爪哇

scoresRef.orderByValue().limitToFirst(3).addChildEventListener(new ChildEventListener() {
  @Override
  public void onChildAdded(DataSnapshot dataSnapshot, String prevChildKey) {
    System.out.println("The " + dataSnapshot.getKey() + " score is " + dataSnapshot.getValue());
  }

  // ...
});

節點.js

const scoresRef = db.ref('scores');
scoresRef.orderByValue().limitToLast(3).on('value', (snapshot)  =>{
  snapshot.forEach((data) => {
    console.log('The ' + data.key + ' dinosaur\'s score is ' + data.val());
  });
});

Python

scores_ref = db.reference('scores')
snapshot = scores_ref.order_by_value().limit_to_last(3).get()
for key, val in snapshot.items():
    print('The {0} dinosaur\'s score is {1}'.format(key, val))

去

ref := client.NewRef("scores")

results, err := ref.OrderByValue().LimitToLast(3).GetOrdered(ctx)
if err != nil {
	log.Fatalln("Error querying database:", err)
}
for _, r := range results {
	var score int
	if err := r.Unmarshal(&score); err != nil {
		log.Fatalln("Error unmarshaling result:", err)
	}
	fmt.Printf("The %s dinosaur's score is %d\n", r.Key(), score)
}

範圍查詢

使用startAt() 、 endAt()和equalTo()允許您為查詢選擇任意起點和終點。例如，如果你想找到所有至少三米高的恐龍，你可以結合使用orderByChild()和startAt() ：

爪哇

dinosaursRef.orderByChild("height").startAt(3).addChildEventListener(new ChildEventListener() {
  @Override
  public void onChildAdded(DataSnapshot dataSnapshot, String prevChildKey) {
    System.out.println(dataSnapshot.getKey());
  }

  // ...
});

節點.js

const ref = db.ref('dinosaurs');
ref.orderByChild('height').startAt(3).on('child_added', (snapshot) => {
  console.log(snapshot.key);
});

Python

ref = db.reference('dinosaurs')
snapshot = ref.order_by_child('height').start_at(3).get()
for key in snapshot:
    print(key)

去

ref := client.NewRef("dinosaurs")

results, err := ref.OrderByChild("height").StartAt(3).GetOrdered(ctx)
if err != nil {
	log.Fatalln("Error querying database:", err)
}
for _, r := range results {
	fmt.Println(r.Key())
}

您可以使用endAt()來查找名稱在字典序上排在 Pterodactyl 之前的所有恐龍：

爪哇

dinosaursRef.orderByKey().endAt("pterodactyl").addChildEventListener(new ChildEventListener() {
  @Override
  public void onChildAdded(DataSnapshot dataSnapshot, String prevChildKey) {
    System.out.println(dataSnapshot.getKey());
  }

  // ...
});

節點.js

const ref = db.ref('dinosaurs');
ref.orderByKey().endAt('pterodactyl').on('child_added', (snapshot) => {
  console.log(snapshot.key);
});

Python

ref = db.reference('dinosaurs')
snapshot = ref.order_by_key().end_at('pterodactyl').get()
for key in snapshot:
    print(key)

去

ref := client.NewRef("dinosaurs")

results, err := ref.OrderByKey().EndAt("pterodactyl").GetOrdered(ctx)
if err != nil {
	log.Fatalln("Error querying database:", err)
}
for _, r := range results {
	fmt.Println(r.Key())
}

startAt()和endAt()是包含在內的，這意味著“翼手龍”將匹配上面的查詢。

您可以結合使用startAt()和endAt()來限制查詢的兩端。以下示例查找名稱以字母“b”開頭的所有恐龍：

爪哇

dinosaursRef.orderByKey().startAt("b").endAt("b\uf8ff").addChildEventListener(new ChildEventListener() {
  @Override
  public void onChildAdded(DataSnapshot dataSnapshot, String prevChildKey) {
    System.out.println(dataSnapshot.getKey());
  }

  // ...
});

節點.js

var ref = db.ref('dinosaurs');
ref.orderByKey().startAt('b').endAt('b\uf8ff').on('child_added', (snapshot) => {
  console.log(snapshot.key);
});

Python

ref = db.reference('dinosaurs')
snapshot = ref.order_by_key().start_at('b').end_at(u'b\uf8ff').get()
for key in snapshot:
    print(key)

去

ref := client.NewRef("dinosaurs")

results, err := ref.OrderByKey().StartAt("b").EndAt("b\uf8ff").GetOrdered(ctx)
if err != nil {
	log.Fatalln("Error querying database:", err)
}
for _, r := range results {
	fmt.Println(r.Key())
}

上面查詢中使用的\uf8ff字符是 Unicode 範圍中非常高的代碼點。因為它在 Unicode 中的大多數常規字符之後，查詢匹配所有以 b 開頭的值。

equalTo()方法允許您根據精確匹配進行過濾。與其他範圍查詢的情況一樣，它將針對每個匹配的子節點觸發。例如，您可以使用以下查詢來查找所有高度為 25 米的恐龍：

爪哇

dinosaursRef.orderByChild("height").equalTo(25).addChildEventListener(new ChildEventListener() {
  @Override
  public void onChildAdded(DataSnapshot dataSnapshot, String prevChildKey) {
    System.out.println(dataSnapshot.getKey());
  }

  // ...
});

節點.js

const ref = db.ref('dinosaurs');
ref.orderByChild('height').equalTo(25).on('child_added', (snapshot) => {
  console.log(snapshot.key);
});

Python

ref = db.reference('dinosaurs')
snapshot = ref.order_by_child('height').equal_to(25).get()
for key in snapshot:
    print(key)

去

ref := client.NewRef("dinosaurs")

results, err := ref.OrderByChild("height").EqualTo(25).GetOrdered(ctx)
if err != nil {
	log.Fatalln("Error querying database:", err)
}
for _, r := range results {
	fmt.Println(r.Key())
}

當您需要對數據進行分頁時，範圍查詢也很有用。

您還可以將orderByValue()與startAt()和endAt()組合起來構造範圍查詢。

把它們放在一起

您可以結合所有這些技術來創建複雜的查詢。例如，您可以找到僅比劍龍短的恐龍名稱：

爪哇

dinosaursRef.child("stegosaurus").child("height").addValueEventListener(new ValueEventListener() {
  @Override
  public void onDataChange(DataSnapshot stegoHeightSnapshot) {
    Integer favoriteDinoHeight = stegoHeightSnapshot.getValue(Integer.class);
    Query query = dinosaursRef.orderByChild("height").endAt(favoriteDinoHeight).limitToLast(2);
    query.addValueEventListener(new ValueEventListener() {
      @Override
      public void onDataChange(DataSnapshot dataSnapshot) {
        // Data is ordered by increasing height, so we want the first entry
        DataSnapshot firstChild = dataSnapshot.getChildren().iterator().next();
        System.out.println("The dinosaur just shorter than the stegosaurus is: " + firstChild.getKey());
      }

      @Override
      public void onCancelled(DatabaseError databaseError) {
        // ...
      }
    });
  }

  @Override
  public void onCancelled(DatabaseError databaseError) {
    // ...
  }
});

節點.js

  const ref = db.ref('dinosaurs');
  ref.child('stegosaurus').child('height').on('value', (stegosaurusHeightSnapshot) => {
    const favoriteDinoHeight = stegosaurusHeightSnapshot.val();

    const queryRef = ref.orderByChild('height').endAt(favoriteDinoHeight).limitToLast(2);
    queryRef.on('value', (querySnapshot) => {
      if (querySnapshot.numChildren() === 2) {
        // Data is ordered by increasing height, so we want the first entry
        querySnapshot.forEach((dinoSnapshot) => {
          console.log('The dinosaur just shorter than the stegasaurus is ' + dinoSnapshot.key);

          // Returning true means that we will only loop through the forEach() one time
          return true;
        });
      } else {
        console.log('The stegosaurus is the shortest dino');
      }
    });
});

Python

ref = db.reference('dinosaurs')
favotire_dino_height = ref.child('stegosaurus').child('height').get()
query = ref.order_by_child('height').end_at(favotire_dino_height).limit_to_last(2)
snapshot = query.get()
if len(snapshot) == 2:
    # Data is ordered by increasing height, so we want the first entry.
    # Second entry is stegosarus.
    for key in snapshot:
        print('The dinosaur just shorter than the stegosaurus is {0}'.format(key))
        return
else:
    print('The stegosaurus is the shortest dino')

去

ref := client.NewRef("dinosaurs")

var favDinoHeight int
if err := ref.Child("stegosaurus").Child("height").Get(ctx, &favDinoHeight); err != nil {
	log.Fatalln("Error querying database:", err)
}

query := ref.OrderByChild("height").EndAt(favDinoHeight).LimitToLast(2)
results, err := query.GetOrdered(ctx)
if err != nil {
	log.Fatalln("Error querying database:", err)
}
if len(results) == 2 {
	// Data is ordered by increasing height, so we want the first entry.
	// Second entry is stegosarus.
	fmt.Printf("The dinosaur just shorter than the stegosaurus is %s\n", results[0].Key())
} else {
	fmt.Println("The stegosaurus is the shortest dino")
}

數據是如何排序的

本節說明在使用四種排序功能中的每一種時如何對數據進行排序。

orderByChild

使用orderByChild()時，包含指定子鍵的數據按如下方式排序：

指定子鍵的null值的子項排在第一位。
接下來是指定子鍵值為false的子項。如果多個孩子的值為false ，則它們按字典順序按鍵排序。
接下來是指定子鍵值為true的子項。如果多個孩子的值為true ，則它們按字典順序按鍵排序。
接下來是具有數值的孩子，按升序排序。如果指定子節點的多個子節點的數值相同，則按key排序。
字符串在數字之後，並按字典順序升序排序。如果指定子節點的多個子節點具有相同的值，則它們按鍵按字典順序排序。
對象排在最後，並按鍵升序按字典順序排序。

orderByKey

當使用orderByKey()對數據進行排序時，數據將按如下鍵按升序返回。請記住，鍵只能是字符串。

具有可以解析為 32 位整數的鍵的孩子排在第一位，按升序排序。
接下來是以字符串值作為鍵的子項，按字典順序升序排序。

按值排序

使用orderByValue()時，子項按其值排序。排序標準與orderByChild()中的相同，除了使用節點的值而不是指定子鍵的值。