Google sử dụng công nghệ AI để dịch nội dung sang ngôn ngữ bạn ưu tiên. Bản dịch bằng AI có thể có lỗi.

Truy xuất dữ liệu

Đọc dữ liệu bằng GET

Chúng ta có thể đọc dữ liệu từ cơ sở dữ liệu Firebase bằng cách gửi yêu cầu GET đến điểm cuối URL của cơ sở dữ liệu đó. Hãy tiếp tục với ví dụ về blog trong phần trước và đọc tất cả dữ liệu bài đăng trên blog:

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

Yêu cầu thành công sẽ được biểu thị bằng mã trạng thái HTTP 200 OK và phản hồi sẽ chứa dữ liệu mà chúng ta đang truy xuất.

Thêm tham số URI

API REST chấp nhận một số tham số truy vấn khi đọc dữ liệu từ cơ sở dữ liệu Firebase. Dưới đây là các tham số thường dùng nhất. Để xem danh sách đầy đủ, hãy tham khảo Tài liệu tham khảo API REST.

auth

Tham số yêu cầu auth cho phép truy cập vào dữ liệu được bảo vệ bằng Firebase Realtime Database Security Rules và được tất cả các loại yêu cầu hỗ trợ. Đối số có thể là khoá bí mật của ứng dụng Firebase hoặc mã xác thực, như mô tả trong phần Người dùng trong dự án Firebase. Trong ví dụ sau, chúng ta gửi một yêu cầu GET có tham số auth, trong đó CREDENTIAL là khoá bí mật của ứng dụng Firebase hoặc mã xác thực:

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

Nếu bạn đặt cờ debug của mã thông báo, thì bạn có thể tìm thấy thông tin gỡ lỗi trong tiêu đề X-Firebase-Auth-Debug của phản hồi.

in

Việc chỉ định print=pretty sẽ trả về dữ liệu ở định dạng con người có thể đọc được.

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

Việc chỉ định print=silent sẽ trả về 204 No Content khi thành công.

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

callback

Để thực hiện lệnh gọi REST từ trình duyệt web trên nhiều miền, bạn có thể sử dụng JSONP để gói phản hồi trong hàm callback JavaScript. Thêm callback= để API REST gói dữ liệu được trả về trong hàm callback mà bạn chỉ định. Ví dụ:

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

nông

Đây là một tính năng nâng cao, được thiết kế để giúp bạn làm việc với các tập dữ liệu lớn mà không cần tải mọi thứ xuống. Để sử dụng, hãy thêm shallow=true làm tham số. Thao tác này sẽ giới hạn độ sâu của dữ liệu được trả về. Nếu dữ liệu tại vị trí đó là một dữ liệu gốc JSON (chuỗi, số hoặc boolean), thì giá trị của dữ liệu đó sẽ được trả về. Nếu ảnh chụp nhanh dữ liệu tại vị trí đó là một đối tượng JSON, thì giá trị của mỗi khoá sẽ được cắt bớt thành true. Ví dụ: sử dụng dữ liệu dưới đây:

{
  "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!"

Hãy thử dùng yêu cầu curl này:

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

shallow không thể dùng được với bất kỳ tham số truy vấn "lọc dữ liệu" nào.

tạm ngừng

Hãy sử dụng thuộc tính này để giới hạn thời gian đọc ở phía máy chủ. Nếu một yêu cầu đọc không hoàn tất trong thời gian quy định, thì yêu cầu đó sẽ kết thúc kèm theo lỗi HTTP 400. Điều này đặc biệt hữu ích khi bạn muốn chuyển một lượng dữ liệu nhỏ và không muốn đợi quá lâu để tìm nạp một cây con có thể rất lớn. Thời gian đọc thực tế có thể thay đổi tuỳ theo kích thước dữ liệu và bộ nhớ đệm.

Chỉ định timeouts bằng định dạng sau: 3ms, 3s hoặc 3min, kèm theo một số và một đơn vị. Nếu không được chỉ định, thì timeout tối đa của 15min sẽ được áp dụng. Nếu timeout không phải là số dương hoặc vượt quá mức tối đa, yêu cầu sẽ bị từ chối kèm theo lỗi HTTP 400. Trong ví dụ sau, yêu cầu GET bao gồm timeout là 10 giây.

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

Lọc dữ liệu

Chúng ta có thể tạo các truy vấn để lọc dữ liệu dựa trên nhiều yếu tố. Để bắt đầu, bạn chỉ định cách lọc dữ liệu bằng tham số orderBy. Sau đó, bạn kết hợp orderBy với bất kỳ tham số nào trong số 5 tham số còn lại: limitToFirst, limitToLast, startAt, endAt và equalTo.

Vì tất cả chúng tôi tại Firebase đều nghĩ rằng khủng long khá thú vị, nên chúng tôi sẽ sử dụng một đoạn mã từ cơ sở dữ liệu mẫu về các thông tin về khủng long để minh hoạ cách bạn có thể lọc dữ liệu:

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

Chúng ta có thể lọc dữ liệu theo một trong ba cách: theo khoá con, theo khoá hoặc theo giá trị. Một truy vấn bắt đầu bằng một trong các tham số này, sau đó phải được kết hợp với một hoặc nhiều tham số sau: startAt, endAt, limitToFirst, limitToLast hoặc equalTo.

Lọc theo khoá con được chỉ định

Chúng ta có thể lọc các nút theo khoá con chung bằng cách truyền khoá đó đến tham số orderBy. Ví dụ: để truy xuất tất cả khủng long có chiều cao lớn hơn 3, chúng ta có thể làm như sau:

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

Mọi nút không có khoá con mà chúng ta đang lọc sẽ được sắp xếp theo giá trị null. Để biết thông tin chi tiết về cách sắp xếp dữ liệu, hãy xem phần Cách sắp xếp dữ liệu.

Firebase cũng hỗ trợ các truy vấn được sắp xếp theo phần tử con lồng sâu, thay vì chỉ phần tử con ở cấp dưới. Điều này rất hữu ích nếu bạn có dữ liệu lồng nhau sâu như sau:

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

Để truy vấn chiều cao, chúng ta sử dụng đường dẫn đầy đủ đến đối tượng thay vì một khoá duy nhất:

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

Mỗi lần, truy vấn chỉ có thể lọc theo một khoá. Việc sử dụng tham số orderBy nhiều lần trong cùng một yêu cầu sẽ gây ra lỗi.

Thêm tính năng Lập chỉ mục vào Firebase Realtime Database Security Rules: Nếu đang sử dụng orderBy trong ứng dụng, bạn cần xác định các khoá mà bạn sẽ lập chỉ mục thông qua quy tắc .indexOn trong Firebase Realtime Database Security Rules. Đọc tài liệu về quy tắc .indexOn để biết thêm thông tin.

Lọc theo khoá

Chúng ta cũng có thể lọc các nút theo khoá bằng cách sử dụng tham số orderBy="$key". Ví dụ sau đây truy xuất tất cả khủng long có tên bắt đầu bằng chữ cái a đến m:

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

Lọc theo giá trị

Chúng ta có thể lọc các nút theo giá trị của khoá con bằng cách sử dụng tham số orderBy="$value". Giả sử khủng long đang tham gia một cuộc thi thể thao và chúng ta đang theo dõi điểm số của chúng theo định dạng sau:

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

Để truy xuất tất cả khủng long có điểm số cao hơn 50, chúng ta có thể đưa ra yêu cầu sau:

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

Hãy xem phần Cách sắp xếp dữ liệu để biết nội dung giải thích về cách sắp xếp các giá trị null, boolean, chuỗi và đối tượng khi sử dụng orderBy="$value".

Thêm tính năng lập chỉ mục vào Firebase Realtime Database Security Rules: Nếu đang sử dụng orderBy="$value" trong ứng dụng, bạn cần thêm .value vào các quy tắc của mình tại chỉ mục thích hợp. Đọc tài liệu về quy tắc .indexOn để biết thêm thông tin.

Lọc phức tạp

Chúng ta có thể kết hợp nhiều tham số để tạo các truy vấn phức tạp hơn.

Giới hạn truy vấn

Các tham số limitToFirst và limitToLast được dùng để đặt số lượng phần tử con tối đa mà bạn muốn nhận dữ liệu. Nếu đặt giới hạn là 100, chúng ta sẽ chỉ nhận được tối đa 100 phần tử con phù hợp. Nếu có ít hơn 100 thông báo được lưu trữ trong cơ sở dữ liệu, chúng ta sẽ nhận được mọi phần tử con. Tuy nhiên, nếu có hơn 100 thông báo, chúng ta sẽ chỉ nhận được dữ liệu cho 100 thông báo trong số đó. Đây sẽ là 100 tin nhắn đầu tiên được sắp xếp nếu chúng ta đang sử dụng limitToFirst hoặc 100 tin nhắn cuối cùng được sắp xếp nếu chúng ta đang sử dụng limitToLast.

Bằng cách sử dụng cơ sở dữ liệu về khủng long và orderBy, chúng ta có thể tìm thấy hai loài khủng long nặng nhất:

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

Tương tự, chúng ta có thể tìm thấy hai loài khủng long thấp nhất bằng cách sử dụng limitToFirst:

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

Chúng ta cũng có thể thực hiện các truy vấn giới hạn bằng orderBy="$value". Nếu muốn tạo một bảng xếp hạng gồm 3 đối thủ có điểm số cao nhất trong trò chơi khủng long, chúng ta có thể làm như sau:

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

Truy vấn phạm vi

Việc sử dụng startAt, endAt và equalTo cho phép chúng ta chọn điểm bắt đầu và điểm kết thúc tuỳ ý cho các truy vấn. Ví dụ: nếu muốn tìm tất cả khủng long cao ít nhất 3 mét, chúng ta có thể kết hợp orderBy và startAt:

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

Chúng ta có thể sử dụng endAt để tìm tất cả loài khủng long có tên đứng trước Pterodactyl theo thứ tự từ điển:

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

startAt và endAt là các ký tự bao gồm, nghĩa là "pterodactyl" sẽ khớp với truy vấn ở trên.

Chúng ta có thể kết hợp startAt và endAt để giới hạn cả hai đầu của truy vấn. Ví dụ sau đây tìm tất cả khủng long có tên bắt đầu bằng chữ cái "b":

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

Ký tự \uf8ff được dùng trong truy vấn ở trên là một điểm mã rất cao trong dải Unicode. Vì ký tự này đứng sau hầu hết các ký tự thông thường trong Unicode, nên truy vấn sẽ khớp với tất cả các giá trị bắt đầu bằng chữ b.

Truy vấn phạm vi cũng hữu ích khi bạn cần phân trang dữ liệu.

Đang kết hợp

Chúng ta có thể kết hợp tất cả các kỹ thuật này để tạo ra các truy vấn phức tạp. Ví dụ: có thể bạn muốn tìm tên của tất cả loài khủng long có chiều cao thấp hơn hoặc bằng loài khủng long mà chúng ta yêu thích, Stegosaurus:

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"

Cách sắp xếp dữ liệu

Phần này giải thích cách sắp xếp dữ liệu khi sử dụng từng tham số trong số ba tham số lọc.

API REST trả về kết quả chưa được sắp xếp: Trình diễn giải JSON không thực thi bất kỳ thứ tự nào trên tập kết quả. Mặc dù bạn có thể dùng orderBy kết hợp với startAt, endAt, limitToFirst hoặc limitToLast để trả về một tập hợp con của dữ liệu, nhưng kết quả trả về sẽ không được sắp xếp. Do đó, bạn có thể cần phải sắp xếp kết quả theo cách thủ công nếu thứ tự là quan trọng.

orderBy

Khi sử dụng orderBy với tên của khoá con, dữ liệu chứa khoá con được chỉ định sẽ được sắp xếp như sau:

Các thành phần con có giá trị null cho khoá con được chỉ định sẽ xuất hiện trước.
Tiếp theo là các phần tử con có giá trị false cho khoá con được chỉ định. Nếu nhiều phần tử con có giá trị false, thì các phần tử đó sẽ được sắp xếp theo thứ tự bảng chữ cái theo khoá.
Tiếp theo là các phần tử con có giá trị true cho khoá con được chỉ định. Nếu nhiều phần tử con có giá trị true, thì các phần tử đó sẽ được sắp xếp theo thứ tự bảng chữ cái theo khoá.
Tiếp theo là các phần tử con có giá trị số, được sắp xếp theo thứ tự tăng dần. Nếu nhiều nút con có cùng giá trị số cho nút con được chỉ định, thì các nút con đó sẽ được sắp xếp theo khoá.
Chuỗi đứng sau số và được sắp xếp theo thứ tự bảng chữ cái tăng dần. Nếu nhiều phần tử con có cùng giá trị cho nút con được chỉ định, thì các phần tử con đó sẽ được sắp xếp theo thứ tự từ điển theo khoá.
Đối tượng nằm ở cuối và được sắp xếp theo thứ tự từ điển theo khoá theo thứ tự tăng dần.

Kết quả đã lọc được trả về mà không theo thứ tự. Nếu thứ tự dữ liệu là quan trọng, bạn nên sắp xếp kết quả trong ứng dụng sau khi Firebase trả về kết quả.

orderBy="$key"

Khi sử dụng tham số orderBy="$key" để sắp xếp dữ liệu, dữ liệu sẽ được trả về theo thứ tự tăng dần theo khoá như sau. Xin lưu ý rằng khoá chỉ có thể là chuỗi.

Các phần tử con có khoá có thể được phân tích cú pháp dưới dạng số nguyên 32 bit sẽ xuất hiện trước, được sắp xếp theo thứ tự tăng dần.
Tiếp theo là các phần tử con có giá trị chuỗi làm khoá, được sắp xếp theo thứ tự từ điển tăng dần.

orderBy="$value"

Khi sử dụng tham số orderBy="$value" để sắp xếp dữ liệu, các phần tử con sẽ được sắp xếp theo giá trị của chúng. Tiêu chí sắp xếp giống như dữ liệu được sắp xếp theo khoá con, ngoại trừ việc giá trị của nút được sử dụng thay vì giá trị của khoá con được chỉ định.

orderBy="$priority"

Khi sử dụng tham số orderBy="$priority" để sắp xếp dữ liệu, thứ tự của các phần tử con được xác định theo mức độ ưu tiên và khoá của chúng như sau. Xin lưu ý rằng giá trị ưu tiên chỉ có thể là số hoặc chuỗi.

Các thành phần con không có mức độ ưu tiên (mặc định) sẽ xuất hiện trước.
Tiếp theo là các phần tử con có số thứ tự ưu tiên. Các bộ lọc này được sắp xếp theo số thứ tự ưu tiên, từ nhỏ đến lớn.
Các phần tử con có mức độ ưu tiên là chuỗi sẽ xuất hiện sau cùng. Các quy tắc này được sắp xếp theo thứ tự từ điển theo mức độ ưu tiên.
Bất cứ khi nào hai phần tử con có cùng mức độ ưu tiên (bao gồm cả trường hợp không có mức độ ưu tiên), chúng sẽ được sắp xếp theo khoá. Các khoá số đứng trước (được sắp xếp theo số), theo sau là các khoá còn lại (được sắp xếp theo thứ tự bảng chữ cái).

Để biết thêm thông tin về mức độ ưu tiên, hãy xem Tài liệu tham khảo API.

Truyền trực tuyến từ API REST

Điểm cuối REST của Firebase hỗ trợ giao thức EventSource/Sự kiện do máy chủ gửi, giúp bạn dễ dàng truyền trực tuyến các thay đổi đến một vị trí duy nhất trong cơ sở dữ liệu Firebase của chúng tôi.

Để bắt đầu phát trực tuyến, chúng ta cần làm như sau:

Đặt tiêu đề Accept của ứng dụng thành text/event-stream
Tuân thủ lệnh chuyển hướng HTTP, đặc biệt là mã trạng thái HTTP 307
Thêm tham số truy vấn auth nếu vị trí cơ sở dữ liệu Firebase yêu cầu quyền đọc

Đổi lại, máy chủ sẽ gửi các sự kiện được đặt tên khi trạng thái của dữ liệu tại URL được yêu cầu thay đổi. Cấu trúc của các thông báo này tuân thủ giao thức EventSource:

event: event name
data: JSON encoded data payload

Máy chủ có thể gửi các sự kiện sau:

put	Dữ liệu được mã hoá JSON sẽ là một đối tượng có hai khoá: đường dẫn và dữ liệu Đường dẫn trỏ đến một vị trí tương ứng với URL yêu cầu Ứng dụng khách phải thay thế tất cả dữ liệu tại vị trí đó trong bộ nhớ đệm bằng dữ liệu được cung cấp trong thông báo
bản vá	Dữ liệu được mã hoá JSON sẽ là một đối tượng có hai khoá: đường dẫn và dữ liệu Đường dẫn trỏ đến một vị trí tương ứng với URL yêu cầu Đối với mỗi khoá trong dữ liệu, ứng dụng khách phải thay thế khoá tương ứng trong bộ nhớ đệm bằng dữ liệu cho khoá đó trong thông báo
duy trì hoạt động	Dữ liệu cho sự kiện này là rỗng, bạn không cần làm gì cả
hủy	Dữ liệu cho sự kiện này là rỗng Sự kiện này sẽ được gửi nếu Firebase Realtime Database Security Rules khiến thao tác đọc tại vị trí được yêu cầu không còn được cho phép nữa
auth_revoked	Dữ liệu cho sự kiện này là một chuỗi cho biết thông tin xác thực đã hết hạn Sự kiện này sẽ được gửi khi tham số xác thực được cung cấp không còn hợp lệ

Dưới đây là ví dụ về một tập hợp sự kiện mà máy chủ có thể gửi:

// 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}}

Nếu bạn đang sử dụng Go, hãy xem Firego, một trình bao bọc của bên thứ ba xung quanh Firebase REST và API Truyền trực tuyến.

Truy xuất dữ liệu Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.

Đọc dữ liệu bằng GET

Thêm tham số URI

auth

in

callback

nông

tạm ngừng

Lọc dữ liệu

Lọc theo khoá con được chỉ định

Lọc theo khoá

Lọc theo giá trị

Lọc phức tạp

Giới hạn truy vấn

Truy vấn phạm vi

Đang kết hợp

Cách sắp xếp dữ liệu

orderBy

orderBy="$key"

orderBy="$value"

orderBy="$priority"

Truyền trực tuyến từ API REST

Truy xuất dữ liệu