Trang này được dịch bởi Cloud Translation API.

Đang lưu dữ liệu

Cách tiết kiệm dữ liệu
ĐẶT	Ghi hoặc thay thế dữ liệu thành một đường dẫn đã xác định, chẳng hạn như `fireblog/users/user1/<data>`
PHÙ HỢP	Cập nhật một số khoá cho đường dẫn đã xác định mà không thay thế tất cả dữ liệu.
ĐĂNG	Thêm vào danh sách dữ liệu trong cơ sở dữ liệu Firebase của chúng tôi. Mỗi lần chúng ta gửi yêu cầu `POST`, ứng dụng Firebase sẽ tạo một khoá duy nhất, chẳng hạn như `fireblog/users/<unique-id>/<data>`
XÓA	Xoá dữ liệu khỏi tham chiếu cơ sở dữ liệu Firebase được chỉ định.

Xin lưu ý rằng tất cả ví dụ đều sử dụng Cơ sở dữ liệu theo thời gian thực của Firebase, docs-example.firebaseio.com, ở chế độ chỉ có thể đọc. Hãy thay thế URL của Cơ sở dữ liệu theo thời gian thực này bằng một URL trong bảng điều khiển của Firebase mà bạn có quyền truy cập.

Ghi dữ liệu bằng PUT

Thao tác ghi cơ bản thông qua API REST là PUT. Để minh hoạ cách tiết kiệm dữ liệu, chúng ta sẽ xây dựng một ứng dụng viết blog với bài đăng và người dùng. Toàn bộ dữ liệu cho ứng dụng của chúng ta sẽ được lưu trữ trong đường dẫn "fireblog", tại URL cơ sở dữ liệu của Firebase "https://docs-examples.firebaseio.com/fireblog".

Hãy bắt đầu bằng cách lưu một số dữ liệu người dùng vào cơ sở dữ liệu Firebase của chúng tôi. Chúng tôi sẽ lưu trữ mỗi người dùng theo một tên người dùng duy nhất, đồng thời chúng tôi cũng sẽ lưu trữ tên đầy đủ và ngày sinh của họ. Vì mỗi người dùng sẽ có một tên người dùng duy nhất. Do đó, bạn nên sử dụng PUT tại đây thay vì POST vì chúng ta đã có khoá này và không cần tạo khoá.

Bằng cách sử dụng PUT, chúng ta có thể ghi một chuỗi, số, boolean, mảng hoặc bất kỳ đối tượng JSON nào vào cơ sở dữ liệu Firebase. Trong trường hợp này, chúng ta sẽ truyền cho đối tượng:

curl -X PUT -d '{
  "alanisawesome": {
    "name": "Alan Turing",
    "birthday": "June 23, 1912"
  }
}' 'https://docs-examples.firebaseio.com/fireblog/users.json'

Khi một đối tượng JSON được lưu vào cơ sở dữ liệu, các thuộc tính của đối tượng sẽ tự động được liên kết với các vị trí con theo cách lồng nhau. Nếu chuyển đến nút mới tạo, chúng ta sẽ thấy giá trị "Alan Turing". Chúng tôi cũng có thể lưu dữ liệu trực tiếp vào một vị trí của trẻ:

curl -X PUT -d '"Alan Turing"' \
  'https://docs-examples.firebaseio.com/fireblog/users/alanisawesome/name.json'

curl -X PUT -d '"June 23, 1912"' \
  'https://docs-examples.firebaseio.com/fireblog/users/alanisawesome/birthday.json'

Hai ví dụ trên – viết giá trị cùng lúc dưới dạng đối tượng và ghi giá trị đó riêng biệt vào các vị trí con – sẽ dẫn đến việc cùng một dữ liệu được lưu vào cơ sở dữ liệu Firebase của chúng tôi:

{
  "users": {
    "alanisawesome": {
      "date_of_birth": "June 23, 1912",
      "full_name": "Alan Turing"
    }
  }
}

Yêu cầu thành công sẽ được biểu thị bằng một mã trạng thái HTTP 200 OK và phản hồi sẽ chứa dữ liệu mà chúng tôi đã ghi vào cơ sở dữ liệu. Ví dụ đầu tiên sẽ chỉ kích hoạt một sự kiện trên các ứng dụng đang xem dữ liệu, trong khi ví dụ thứ hai sẽ kích hoạt hai sự kiện. Điều quan trọng cần lưu ý là nếu dữ liệu đã tồn tại tại đường dẫn của người dùng, thì phương thức đầu tiên sẽ ghi đè dữ liệu đó, nhưng phương thức thứ hai sẽ chỉ sửa đổi giá trị của từng nút con riêng biệt trong khi vẫn giữ nguyên các nút con khác. PUT tương đương với set() trong SDK JavaScript của chúng tôi.

Cập nhật dữ liệu bằng PATCH

Khi sử dụng yêu cầu PATCH, chúng ta có thể cập nhật các thành phần con cụ thể tại một vị trí mà không cần ghi đè dữ liệu hiện có. Hãy thêm biệt hiệu của Turing vào dữ liệu người dùng của anh ấy bằng yêu cầu PATCH:

curl -X PATCH -d '{
  "nickname": "Alan The Machine"
}' \
  'https://docs-examples.firebaseio.com/fireblog/users/alanisawesome.json'

Yêu cầu ở trên sẽ ghi nickname vào đối tượng alanisawesome mà không xoá các phần tử con name hoặc birthday. Xin lưu ý rằng nếu chúng tôi đưa ra yêu cầu PUT tại đây, thì name và birthday sẽ bị xoá vì không có trong yêu cầu. Dữ liệu trong cơ sở dữ liệu Firebase của chúng tôi giờ đây sẽ có dạng như sau:

{
  "users": {
    "alanisawesome": {
      "date_of_birth": "June 23, 1912",
      "full_name": "Alan Turing",
      "nickname": "Alan The Machine"
    }
  }
}

Yêu cầu thành công sẽ được biểu thị bằng một mã trạng thái HTTP 200 OK và phản hồi sẽ chứa dữ liệu cập nhật được ghi vào cơ sở dữ liệu.

Firebase cũng hỗ trợ cập nhật theo nhiều đường dẫn. Điều này có nghĩa là PATCH hiện có thể cập nhật các giá trị ở nhiều vị trí trong cơ sở dữ liệu Firebase cùng một lúc. Đây là một tính năng mạnh mẽ cho phép bạn chuẩn hoá dữ liệu của mình. Khi sử dụng bản cập nhật nhiều đường dẫn, chúng ta có thể thêm biệt hiệu cho cả Alan và Grace cùng một lúc:

curl -X PATCH -d '{
  "alanisawesome/nickname": "Alan The Machine",
  "gracehopper/nickname": "Amazing Grace"
}' \
  'https://docs-examples.firebaseio.com/fireblog/users.json'

Sau lần cập nhật này, cả Alan và Grace đều đã thêm biệt hiệu:

{
  "users": {
    "alanisawesome": {
      "date_of_birth": "June 23, 1912",
      "full_name": "Alan Turing",
      "nickname": "Alan The Machine"
    },
    "gracehop": {
      "date_of_birth": "December 9, 1906",
      "full_name": "Grace Hopper",
      "nickname": "Amazing Grace"
    }
  }
}

Lưu ý rằng việc cố gắng cập nhật đối tượng bằng cách ghi đối tượng có đường dẫn sẽ dẫn đến hành vi khác. Hãy xem điều gì sẽ xảy ra nếu chúng ta cố gắng cập nhật Grace và Alan theo cách này:

curl -X PATCH -d '{
  "alanisawesome": {"nickname": "Alan The Machine"},
  "gracehopper": {"nickname": "Amazing Grace"}
}' \
  'https://docs-examples.firebaseio.com/fireblog/users.json'

Điều này dẫn đến nhiều hành vi khác nhau, cụ thể là ghi đè toàn bộ nút /fireblog/users:

{
  "users": {
    "alanisawesome": {
      "nickname": "Alan The Machine"
    },
    "gracehop": {
      "nickname": "Amazing Grace"
    }
  }
}

Cập nhật dữ liệu bằng yêu cầu có điều kiện

Bạn có thể sử dụng các yêu cầu có điều kiện (REST tương đương với giao dịch) để cập nhật dữ liệu theo trạng thái hiện có. Ví dụ: nếu bạn muốn tăng bộ đếm lượt tán thành và muốn đảm bảo số lượng phản ánh chính xác nhiều lượt tán thành đồng thời, hãy sử dụng một yêu cầu có điều kiện để ghi giá trị mới vào bộ đếm. Thay vì 2 lượt ghi thay đổi bộ đếm về cùng một số, một trong các yêu cầu ghi không thành công và sau đó bạn có thể thử lại yêu cầu bằng giá trị mới.

Để thực hiện yêu cầu có điều kiện tại một vị trí, hãy lấy giá trị nhận dạng duy nhất cho dữ liệu hiện tại ở vị trí đó, hoặc thẻ ETag. Nếu dữ liệu thay đổi tại vị trí đó, ETag cũng thay đổi. Bạn có thể yêu cầu ETag bằng bất kỳ phương thức nào khác ngoài PATCH. Ví dụ sau đây sử dụng một yêu cầu GET.
```
curl -i 'https://test.example.com/posts/12345/upvotes.json' -H 'X-Firebase-ETag: true'
```
Việc gọi ETag cụ thể trong tiêu đề sẽ trả về ETag của vị trí được chỉ định trong phản hồi HTTP.
```
HTTP/1.1 200 OK
Content-Length: 6
Content-Type: application/json; charset=utf-8
Access-Control-Allow-Origin: *
ETag: [ETAG_VALUE]
Cache-Control: no-cache

10 // Current value of the data at the specified location
```
Đưa ETag được trả về vào yêu cầu PUT hoặc DELETE tiếp theo để cập nhật dữ liệu khớp cụ thể với giá trị ETag đó. Theo ví dụ của chúng tôi, để cập nhật bộ đếm thành 11 hoặc 1 lớn hơn giá trị tìm nạp ban đầu là 10 và không thực hiện được yêu cầu nếu giá trị không còn khớp, hãy sử dụng mã sau:
```
curl -iX PUT -d '11' 'https://[PROJECT_ID].firebaseio.com/posts/12345/upvotes.json' -H 'if-match:[ETAG_VALUE]'
```
Nếu giá trị dữ liệu ở vị trí được chỉ định vẫn là 10, ETag trong yêu cầu PUT khớp và yêu cầu thành công, ghi 11 vào cơ sở dữ liệu.
```
HTTP/1.1 200 OK
Content-Length: 6
Content-Type: application/json; charset=utf-8
Access-Control-Allow-Origin: *
Cache-Control: no-cache

11 // New value of the data at the specified location, written by the conditional request
```
Nếu vị trí không còn khớp với ETag, điều này có thể xảy ra khi một người dùng khác viết giá trị mới cho cơ sở dữ liệu, thì yêu cầu sẽ không thành công mà không ghi vào vị trí. Phản hồi trả lại hàng bao gồm giá trị mới và ETag.
```
HTTP/1.1 412 Precondition Failed
Content-Length: 6
Content-Type: application/json; charset=utf-8
Access-Control-Allow-Origin: *
ETag: [ETAG_VALUE]
Cache-Control: no-cache

12 // New value of the data at the specified location
```
Hãy sử dụng thông tin mới nếu bạn quyết định thử yêu cầu lại. Cơ sở dữ liệu theo thời gian thực không tự động thử lại các yêu cầu có điều kiện nhưng không thành công. Tuy nhiên, bạn có thể sử dụng giá trị mới và ETag để tạo một yêu cầu có điều kiện mới bằng thông tin mà phản hồi không thành công trả về.

Các yêu cầu có điều kiện dựa trên REST sẽ triển khai tiêu chuẩn HTTP if-match. Tuy nhiên, chúng khác với tiêu chuẩn ở những điểm sau:

Bạn chỉ có thể cung cấp một giá trị ETag cho từng yêu cầu nếu khớp, chứ không được cung cấp nhiều giá trị.
Mặc dù tiêu chuẩn đề xuất trả về ETag trong tất cả các yêu cầu, nhưng Cơ sở dữ liệu theo thời gian thực chỉ trả về ETag với các yêu cầu bao gồm cả tiêu đề X-Firebase-ETag. Điều này giúp giảm chi phí thanh toán cho các yêu cầu thông thường.

Yêu cầu có điều kiện cũng có thể chậm hơn so với các yêu cầu REST thông thường.

Đang lưu danh sách dữ liệu

Để tạo một khoá duy nhất dựa trên dấu thời gian cho mỗi thành phần con được thêm vào tệp tham chiếu cơ sở dữ liệu Firebase, chúng ta có thể gửi một yêu cầu POST. Đối với đường dẫn users, chúng ta nên xác định các khoá của riêng chúng ta vì mỗi người dùng có một tên người dùng duy nhất. Tuy nhiên, khi người dùng thêm bài đăng trên blog vào ứng dụng, chúng tôi sẽ dùng yêu cầu POST để tự động tạo khoá cho mỗi bài đăng trên blog:

curl -X POST -d '{
  "author": "alanisawesome",
  "title": "The Turing Machine"
}' 'https://docs-examples.firebaseio.com/fireblog/posts.json'

Đường dẫn posts của chúng ta hiện có dữ liệu sau:

{
  "posts": {
    "-JSOpn9ZC54A4P4RoqVa": {
      "author": "alanisawesome",
      "title": "The Turing Machine"
    }
  }
}

Xin lưu ý rằng khoá -JSOpn9ZC54A4P4RoqVa được tạo tự động cho chúng ta vì chúng ta đã sử dụng yêu cầu POST. 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 khoá của dữ liệu mới đã được thêm:

{"name":"-JSOpn9ZC54A4P4RoqVa"}

Xoá dữ liệu

Để xoá dữ liệu khỏi cơ sở dữ liệu, chúng ta có thể gửi yêu cầu DELETE kèm theo URL của đường dẫn mà chúng ta muốn xoá dữ liệu. Thao tác sau sẽ xoá Alan khỏi đường dẫn users của chúng tôi:

curl -X DELETE \
  'https://docs-examples.firebaseio.com/fireblog/users/alanisawesome.json'

Yêu cầu DELETE thành công sẽ được biểu thị bằng mã trạng thái HTTP 200 OK có phản hồi chứa JSON null.

Tham số URI

API REST chấp nhận các tham số URI sau đây khi ghi dữ liệu vào cơ sở dữ liệu:

xác thực

Tham số yêu cầu auth cho phép truy cập vào dữ liệu được bảo vệ bằng Quy tắc bảo mật cơ sở dữ liệu theo thời gian thực của Firebase và được tất cả các loại yêu cầu hỗ trợ. Đối số có thể là mã thông báo bí mật của ứng dụng Firebase hoặc mã xác thực mà chúng tôi sẽ đề cập trong phần uỷ quyền của người dùng. Trong ví dụ sau, chúng tôi gửi yêu cầu POST có tham số auth, trong đó CREDENTIAL là mã thông báo bí mật của ứng dụng Firebase hoặc mã thông báo xác thực:

curl -X POST -d '{"Authenticated POST request"}' \
  'https://docs-examples.firebaseio.com/auth-example.json?auth=CREDENTIAL'

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

in

Tham số print cho phép chúng ta chỉ định định dạng của phản hồi từ cơ sở dữ liệu. Việc thêm print=pretty vào yêu cầu của chúng ta sẽ trả về dữ liệu ở định dạng mà con người có thể đọc được. print=pretty được hỗ trợ trong các yêu cầu GET, PUT, POST, PATCH và DELETE.

Để chặn đầu ra từ máy chủ khi ghi dữ liệu, chúng ta có thể thêm print=silent vào yêu cầu của mình. Phản hồi thu được sẽ trống và được biểu thị bằng mã trạng thái HTTP 204 No Content nếu yêu cầu thành công. print=silent được các yêu cầu GET, PUT, POST và PATCH hỗ trợ.

Ghi giá trị máy chủ

Bạn có thể viết các giá trị máy chủ tại một vị trí bằng cách sử dụng giá trị phần giữ chỗ (là đối tượng chỉ có một khoá ".sv"). Giá trị cho khoá đó là loại giá trị máy chủ mà chúng ta muốn đặt. Ví dụ: để đặt dấu thời gian khi tạo một người dùng, chúng ta có thể làm như sau:

curl -X PUT -d '{".sv": "timestamp"}' \
  'https://docs-examples.firebaseio.com/alanisawesome/createdAt.json'

"timestamp" là giá trị máy chủ duy nhất được hỗ trợ và là thời gian kể từ thời gian bắt đầu của hệ thống UNIX tính bằng mili giây.

Cải thiện hiệu suất ghi

Nếu đang ghi một lượng lớn dữ liệu vào cơ sở dữ liệu, chúng ta có thể dùng tham số print=silent để cải thiện hiệu suất ghi và giảm mức sử dụng băng thông. Ở hành vi ghi thông thường, máy chủ sẽ phản hồi bằng dữ liệu JSON đã ghi. Khi bạn chỉ định print=silent, máy chủ sẽ đóng kết nối ngay sau khi nhận được dữ liệu, nhờ đó giảm mức sử dụng băng thông.

Trong trường hợp gửi nhiều yêu cầu đến cơ sở dữ liệu, chúng ta có thể sử dụng lại kết nối HTTPS bằng cách gửi yêu cầu Keep-Alive trong tiêu đề HTTP.

Các điều kiện về lỗi

API REST sẽ trả về mã lỗi trong những trường hợp sau:

Mã trạng thái HTTP
400 Yêu cầu không hợp lệ	Một trong các điều kiện lỗi sau: Không thể phân tích cú pháp dữ liệu `PUT` hoặc `POST`. Thiếu dữ liệu `PUT` hoặc `POST`. Yêu cầu cố gắng `PUT` hoặc `POST` dữ liệu quá lớn. Lệnh gọi API REST chứa tên con không hợp lệ trong đường dẫn. Đường dẫn của lệnh gọi API REST quá dài. Yêu cầu có chứa giá trị máy chủ không được nhận dạng. Chỉ mục cho truy vấn không được xác định trong Quy tắc bảo mật cơ sở dữ liệu theo thời gian thực của Firebase. Yêu cầu không hỗ trợ một trong các tham số truy vấn được chỉ định. Yêu cầu này kết hợp các tham số truy vấn với một yêu cầu `GET` nông.
401 Không được phép	Một trong các điều kiện lỗi sau: Mã thông báo xác thực đã hết hạn. Mã thông báo xác thực được sử dụng trong yêu cầu không hợp lệ. Không xác thực được bằng access_token. Yêu cầu này vi phạm Quy tắc bảo mật cơ sở dữ liệu theo thời gian thực của Firebase.
404 Không tìm thấy	Không tìm thấy cơ sở dữ liệu Firebase được chỉ định.
500 Lỗi máy chủ nội bộ	Máy chủ trả về một lỗi. Hãy xem thông báo lỗi để biết thêm chi tiết.
503 Dịch vụ không hoạt động	Cơ sở dữ liệu theo thời gian thực của Firebase đã chỉ định tạm thời không hoạt động. Điều này có nghĩa là yêu cầu chưa được thử.

Bảo mật dữ liệu

Firebase có ngôn ngữ bảo mật cho phép chúng ta xác định những người dùng có quyền đọc và ghi đối với các nút khác nhau trong dữ liệu của chúng ta. Bạn có thể đọc thêm về vấn đề này trong Quy tắc bảo mật cơ sở dữ liệu theo thời gian thực.

Giờ đây, khi đã đề cập đến cách lưu dữ liệu, chúng ta có thể tìm hiểu cách truy xuất dữ liệu từ cơ sở dữ liệu Firebase thông qua API REST trong phần tiếp theo.

Đang lưu dữ liệu

Cách tiết kiệm dữ liệu

Ghi dữ liệu bằng PUT

Cập nhật dữ liệu bằng PATCH

Cập nhật dữ liệu bằng yêu cầu có điều kiện

Đang lưu danh sách dữ liệu

Xoá dữ liệu

Tham số URI

xác thực

in

Ghi giá trị máy chủ

Cải thiện hiệu suất ghi

Các điều kiện về lỗi

Bảo mật dữ liệu