檢索數據

使用 GET 讀取數據

我們可以通過向 Firebase 數據庫的 URL 端點發出GET請求來讀取數據。讓我們繼續上一節中的博客示例並閱讀我們所有的博客文章數據：

curl 'https://docs-examples.firebaseio.com/fireblog/posts.json?print=pretty'

成功的請求將由200 OK HTTP 狀態代碼指示，並且響應將包含我們正在檢索的數據。

添加 URI 參數

從 Firebase 數據庫讀取數據時，REST API 接受多個查詢參數。下面列出了最常用的參數。有關完整列表，請參閱REST API 參考。

授權

auth請求參數允許訪問受Firebase 實時數據庫安全規則保護的數據，並且所有請求類型都支持。該參數可以是您的 Firebase 應用程序的密鑰或身份驗證令牌，如Firebase 項目中的用戶中所述。在以下示例中，我們發送帶有auth參數的GET請求，其中CREDENTIAL是您的 Firebase 應用程序的密鑰或身份驗證令牌：

curl 'https://docs-examples.firebaseio.com/auth-example.json?auth=CREDENTIAL'

打印

指定print=pretty以人類可讀的格式返回數據。

curl 'https://docs-examples.firebaseio.com/fireblog/posts.json?print=pretty'

指定print=silent成功時會返回204 No Content 。

curl 'https://docs-examples.firebaseio.com/fireblog/posts.json?print=silent'

打回來

要從 Web 瀏覽器跨域進行 REST 調用，您可以使用JSONP將響應包裝在 JavaScript 回調函數中。添加callback=以使REST API 將返回的數據包裝在您指定的回調函數中。例如：

<script>
  function gotData(data) {
    console.log(data);
  }
</script>
<script src="https://docs-examples.firebaseio.com/fireblog/posts.json?callback=gotData">

淺的

這是一項高級功能，旨在幫助您處理大型數據集，而無需下載所有內容。要使用它，請添加shallow=true作為參數。這將限制返回數據的深度。如果該位置的數據是 JSON 原語（字符串、數字或布爾值），則將簡單地返回其值。如果該位置的數據快照是 JSON 對象，則每個鍵的值將被截斷為true 。例如，使用以下數據：

{
  "message": {
    "user": {
      "name": "Chris"
    },
    "body": "Hello!"
  }
}

// A request to /message.json?shallow=true
// would return the following:
{
  "user": true,
  "body": true
}

// A request to /message/body.json?shallow=true
// would simply return:
"Hello!"

嘗試使用以下curl請求：

curl 'https://docs-examples.firebaseio.com/rest/retrieving-data.json?shallow=true&print=pretty'

暫停

使用它來限制服務器端讀取所需的時間。如果讀取請求未在指定時間內完成，則會終止並顯示 HTTP 400 錯誤。當您期望傳輸少量數據並且不想等待太長時間來獲取可能巨大的子樹時，這特別有用。實際讀取時間可能會因數據大小和緩存而異。

使用以下格式指定timeouts ： 3ms 、 3s或3min ，並帶有數字和單位。如果未指定，則將應用最大timeout 15min 。如果timeout不為正數或超過最大值，則請求將被拒絕，並出現 HTTP 400 錯誤。在以下示例中， GET請求包含 10 秒的timeout 。

curl 'https://docs-examples.firebaseio.com/rest/retrieving-data.json?timeout=10s'

過濾數據

我們可以構建查詢來根據各種因素過濾數據。首先，您可以使用orderBy參數指定如何過濾數據。然後，將orderBy與其他五個參數中的任何一個相結合： limitToFirst 、 limitToLast 、 startAt 、 endAt和equalTo 。

由於 Firebase 的所有人都認為恐龍非常酷，因此我們將使用恐龍事實示例數據庫中的片段來演示如何過濾數據：

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

我們可以通過以下三種方式之一過濾數據：按子鍵、按鍵或按值。查詢以這些參數之一開始，然後必須與以下一個或多個參數組合： startAt 、 endAt 、 limitToFirst 、 limitToLast或equalTo 。

按指定子鍵過濾

我們可以通過將公共子鍵傳遞給orderBy參數來過濾節點。例如，要檢索所​​有高度大於 3 的恐龍，我們可以執行以下操作：

curl 'https://dinosaur-facts.firebaseio.com/dinosaurs.json?orderBy="height"&startAt=3&print=pretty'

任何不具有我們要過濾的子鍵的節點都將使用null值進行排序。有關數據如何排序的詳細信息，請參閱數據如何排序。

Firebase 還支持按深度嵌套的子級排序的查詢，而不僅僅是下一級的子級。如果您有像這樣的深度嵌套數據，這非常有用：

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

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

curl 'https://dinosaur-facts.firebaseio.com/dinosaurs.json?orderBy="dimensions/height"&startAt=3&print=pretty'

查詢一次只能按一個鍵進行過濾。對同一請求多次使用orderBy參數會引發錯誤。

按鍵過濾

我們還可以使用orderBy="$key"參數按鍵過濾節點。以下示例檢索名稱以字母a到m開頭的所有恐龍：

curl 'https://dinosaur-facts.firebaseio.com/dinosaurs.json?orderBy="$key"&startAt="a"&endAt="m"&print=pretty'

按值過濾

我們可以使用orderBy="$value"參數按子鍵的值過濾節點。假設恐龍正在進行一場恐龍體育比賽，我們用以下格式記錄他們的得分：

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

要檢索所有得分高於 50 的恐龍，我們可以提出以下請求：

curl 'https://dinosaur-facts.firebaseio.com/scores.json?orderBy="$value"&startAt=50&print=pretty'

有關使用orderBy="$value"時如何對null 、布爾值、字符串和對象值進行排序的說明，請參閱數據的排序方式。

複雜過濾

我們可以組合多個參數來構造更複雜的查詢。

限制查詢

limitToFirst和limitToLast參數用於設置接收數據的子級的最大數量。如果我們將限制設置為 100，那麼我們最多只能接收 100 個匹配的孩子。如果數據庫中存儲的消息少於 100 條，我們將收到每個子消息。但是，如果我們有超過 100 條消息，我們將僅接收其中 100 條消息的數據。如果我們使用limitToFirst ，這些將是前 100 條有序消息；如果我們使用limitToLast ，這些將是最後 100 條有序消息。

使用我們的恐龍事實數據庫和orderBy ，我們可以找到兩種最重的恐龍：

curl 'https://dinosaur-facts.firebaseio.com/dinosaurs.json?orderBy="weight"&limitToLast=2&print=pretty'

類似地，我們可以使用limitToFirst找到兩個最短的恐龍：

curl 'https://dinosaur-facts.firebaseio.com/dinosaurs.json?orderBy="height"&limitToFirst=2&print=pretty'

我們還可以使用orderBy="$value"進行限制查詢。如果我們想創建一個包含得分最高的前三名恐龍體育運動員的排行榜，我們可以執行以下操作：

curl 'https://dinosaur-facts.firebaseio.com/scores.json?orderBy="$value"&limitToLast=3&print=pretty'

範圍查詢

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

curl 'https://dinosaur-facts.firebaseio.com/dinosaurs.json?orderBy="height"&startAt=3&print=pretty'

我們可以使用endAt來查找按字典順序排列在翼手龍之前的所有恐龍：

curl 'https://dinosaur-facts.firebaseio.com/dinosaurs.json?orderBy="$key"&endAt="pterodactyl"&print=pretty'

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

curl 'https://dinosaur-facts.firebaseio.com/dinosaurs.json?orderBy="$key"&startAt="b"&endAt="b\uf8ff"&print=pretty'

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

把它們放在一起

我們可以結合所有這些技術來創建複雜的查詢。例如，也許您想查找所有身高小於或等於我們最喜歡的恐龍劍龍的恐龍的名稱：

MY_FAV_DINO_HEIGHT=`curl "https://dinosaur-facts.firebaseio.com/dinosaurs/stegosaurus/height.json"`
curl "https://dinosaur-facts.firebaseio.com/dinosaurs.json?orderBy=\"height\"&endAt=${MY_FAV_DINO_HEIGHT}&print=pretty"

數據如何排序

本節介紹在使用三個過濾參數中的每一個時如何對數據進行排序。

排序依據

當使用帶有子鍵名稱的orderBy時，包含指定子鍵的數據將按如下方式排序：

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

orderBy="$key"

當使用orderBy="$key"參數對數據進行排序時，數據將按 key 升序返回，如下所示。請記住，鍵只能是字符串。

1. 具有可解析為 32 位整數的鍵的子項排在前面，按升序排序。
2. 接下來是以字符串值作為鍵的子項，按字典順序升序排列。

orderBy=“$值”

當使用orderBy="$value"參數對數據進行排序時，子項將按其值排序。排序標準與按子鍵排序的數據相同，只是使用節點的值而不是指定子鍵的值。

orderBy="$優先級"

當使用orderBy="$priority"參數對數據進行排序時，子項的順序由其優先級和鍵確定，如下所示。請記住，優先級值只能是數字或字符串。

1. 沒有優先級（默認）的孩子首先出現。
2. 接下來是優先考慮數字的孩子。它們按優先級從小到大按數字排序。
3. 優先考慮繩子的孩子排在最後。它們按優先級按字典順序排序。
4. 每當兩個孩子具有相同的優先級（包括沒有優先級）時，它們就會按鍵排序。數字鍵排在前面（按數字排序），然後是其餘鍵（按字典順序排序）。

有關優先級的更多信息，請參閱API 參考。

從 REST API 進行流式傳輸

Firebase REST 端點支持EventSource / 服務器發送事件協議，可以輕鬆地將更改流式傳輸到 Firebase 數據庫中的單個位置。

要開始流式傳輸，我們需要執行以下操作：

1. 將客戶端的 Accept header 設置為text/event-stream
2. 尊重 HTTP 重定向，特別是 HTTP 狀態代碼 307
3. 如果 Firebase 數據庫位置需要讀取權限，請包含auth查詢參數

作為回報，服務器將在請求的 URL 處的數據狀態發生變化時發送命名事件。這些消息的結構符合EventSource協議：

event: event name
data: JSON encoded data payload

服務器可能會發送以下事件：

以下是服務器可能發送的一組事件的示例：

// Set your entire cache to {"a": 1, "b": 2}
event: put
data: {"path": "/", "data": {"a": 1, "b": 2}}


// Put the new data in your cache under the key 'c', so that the complete cache now looks like:
// {"a": 1, "b": 2, "c": {"foo": true, "bar": false}}
event: put
data: {"path": "/c", "data": {"foo": true, "bar": false}}


// For each key in the data, update (or add) the corresponding key in your cache at path /c,
// for a final cache of: {"a": 1, "b": 2, "c": {"foo": 3, "bar": false, "baz": 4}}
event: patch
data: {"path": "/c", "data": {"foo": 3, "baz": 4}}

如果您使用 Go，請查看Firego ，它是 Firebase REST 和 Streaming API 的第三方包裝器。