Quản lý cơ sở dữ liệu

Trang này mô tả cách tạo, cập nhật và xoá cơ sở dữ liệu Cloud Firestore. Bạn có thể tạo nhiều cơ sở dữ liệu Cloud Firestore cho mỗi dự án. Bạn có thể sử dụng nhiều cơ sở dữ liệu để thiết lập môi trường thử nghiệm và môi trường thực tế, tách biệt dữ liệu khách hàng và bản địa hoá dữ liệu.

Vai trò và quyền bắt buộc

Để tạo và quản lý cơ sở dữ liệu, bạn cần có vai trò sau đây trong Quản lý danh tính và quyền truy cập:

• Chủ sở hữu Cloud Datastore (roles/datastore.owner)

Vai trò đó cấp các quyền sau đây mà bạn cần để tạo và quản lý cơ sở dữ liệu:

• Tạo cơ sở dữ liệu: datastore.databases.create
• Đọc cấu hình cơ sở dữ liệu: datastore.databases.getMetadata
• Định cấu hình cơ sở dữ liệu: datastore.databases.update
• Xoá cơ sở dữ liệu: datastore.databases.delete
• Sao chép cơ sở dữ liệu: datastore.databases.clone

Tạo cơ sở dữ liệu

Để tạo cơ sở dữ liệu, hãy sử dụng một trong các phương thức sau:

firebase firestore:databases:create DATABASE_ID \n--location=LOCATION \n[--edition EDITION] \n[--firestore-data-access FIRESTORE_ACCESS] \n[--realtime-updates REALTIME_UPDATES] \n[--delete-protection DELETE_PROTECTION_ENABLEMENT]

resource "google_firestore_database" "database" {
  project     = "project-id"
  name        = DATABASE_ID
  location_id = LOCATION
  type        = DATABASE_TYPE

  // Optional
  delete_protection_state = DELETE_PROTECTION_STATE
}

Mã cơ sở dữ liệu

Mã nhận dạng cơ sở dữ liệu hợp lệ phải tuân thủ các quy tắc sau:

• Chỉ bao gồm các ký tự chữ cái, số và dấu gạch nối (-).
• Chữ cái phải là chữ thường.
• Ký tự đầu tiên phải là một chữ cái.
• Ký tự cuối cùng phải là một chữ cái hoặc số.
• Tối thiểu 4 ký tự.
• Có tối đa 63 ký tự.
• Không được là UUID hoặc giống UUID. Ví dụ: không sử dụng mã nhận dạng như f47ac10b-58cc-0372-8567-0e02b2c3d479.

Có một ngoại lệ đối với các quy tắc này: Phiên bản Standard sẽ tạo một cơ sở dữ liệu có tên là (default) nếu bạn không tự nhập mã nhận dạng.

Xin lưu ý rằng sau khi xoá một cơ sở dữ liệu, bạn không thể sử dụng lại mã nhận dạng của cơ sở dữ liệu đó trong khoảng 5 phút.

Xoá chế độ bảo vệ

Sử dụng tính năng bảo vệ xoá để ngăn chặn việc vô tình xoá cơ sở dữ liệu. Bạn không thể xoá cơ sở dữ liệu đã bật tính năng bảo vệ xoá cho đến khi tắt tính năng này. Tính năng bảo vệ xoá bị tắt theo mặc định. Bạn có thể cập nhật cấu hình cơ sở dữ liệu để bật hoặc tắt tính năng bảo vệ xoá.

Thiết lập Cloud Firestore Security Rules cho cơ sở dữ liệu

Sử dụng CLI Firebase để triển khai Cloud Firestore Security Rules cho từng cơ sở dữ liệu của bạn. Tham khảo hướng dẫn quản lý và triển khai Cloud Firestore Security Rules.

Truy cập vào một cơ sở dữ liệu được đặt tên bằng thư viện ứng dụng

Cơ sở dữ liệu có tên bao gồm mọi cơ sở dữ liệu không có tên (default). Theo mặc định, Firebase SDK và Thư viện ứng dụng API của Google sẽ kết nối với cơ sở dữ liệu (default) Cloud Firestore trong một dự án. Để tạo một ứng dụng khách được kết nối với một cơ sở dữ liệu được đặt tên, hãy đặt mã cơ sở dữ liệu khi bạn tạo thực thể cho ứng dụng khách.

Liệt kê cơ sở dữ liệu

Sử dụng một trong các phương thức sau để liệt kê cơ sở dữ liệu của bạn:

gcloud firestore databases list

firebase firestore:databases:list

Xem thông tin chi tiết về cơ sở dữ liệu

Để xem thông tin chi tiết về một cơ sở dữ liệu, hãy sử dụng một trong các phương thức sau:

gcloud firestore databases describe --database=DATABASE_ID

firebase firestore:databases:get DATABASE_ID

Thay thế DATABASE_ID bằng mã nhận dạng cơ sở dữ liệu.

Cập nhật cấu hình cơ sở dữ liệu

Để cập nhật chế độ cài đặt cấu hình của một cơ sở dữ liệu, hãy sử dụng lệnh gcloud firestore databases update. Sử dụng lệnh này để thay đổi nhằm bật hoặc tắt tính năng bảo vệ xoá.

Cập nhật chế độ cài đặt bảo vệ xoá

Để bật tính năng bảo vệ xoá trên cơ sở dữ liệu, hãy sử dụng lệnh gcloud firestore databases update có cờ --delete-protection. Ví dụ:

gcloud firestore databases update --database=DATABASE_ID --delete-protection

Thay thế DATABASE_ID bằng mã nhận dạng cơ sở dữ liệu.

Để tắt tính năng bảo vệ xoá trên cơ sở dữ liệu, hãy sử dụng lệnh gcloud firestore databases update có cờ --no-delete-protection. Ví dụ:

gcloud firestore databases update --database=DATABASE_ID --no-delete-protection

Thay thế DATABASE_ID bằng mã nhận dạng cơ sở dữ liệu.

Xoá cơ sở dữ liệu

Để xoá cơ sở dữ liệu, hãy sử dụng bảng điều khiển hoặc công cụ dòng lệnh.

Nếu cơ sở dữ liệu đã bật chế độ cài đặt bảo vệ xoá, trước tiên, bạn phải tắt chế độ bảo vệ xoá.

Nếu cơ sở dữ liệu chứa App Engine dữ liệu tìm kiếm hoặc thực thể blob, thì trước tiên, bạn phải xoá dữ liệu đó.

Việc xoá cơ sở dữ liệu sẽ không tự động xoá bất kỳ Eventarctrình kích hoạt nào cho cơ sở dữ liệu đó. Trình kích hoạt ngừng phân phối sự kiện nhưng vẫn tiếp tục tồn tại cho đến khi bạn xoá trình kích hoạt.

Bạn sẽ không bị tính phí cho thao tác xoá khi xoá cơ sở dữ liệu.

gcloud firestore databases delete --database=DATABASE_ID

Sao chép cơ sở dữ liệu

Bạn có thể sao chép một cơ sở dữ liệu hiện có tại một dấu thời gian đã chọn vào một cơ sở dữ liệu mới:

• Cơ sở dữ liệu được sao chép là một cơ sở dữ liệu mới sẽ được tạo ở cùng vị trí với cơ sở dữ liệu nguồn.

  Để tạo bản sao, Cloud Firestore sử dụng dữ liệu khôi phục tại thời điểm cụ thể (PITR) của cơ sở dữ liệu nguồn. Cơ sở dữ liệu được sao chép bao gồm tất cả dữ liệu và chỉ mục.

• Theo mặc định, cơ sở dữ liệu được sao chép sẽ được mã hoá theo cùng cách với cơ sở dữ liệu nguồn, sử dụng phương thức mã hoá mặc định của Google hoặc phương thức mã hoá CMEK. Bạn có thể chỉ định một loại mã hoá khác hoặc sử dụng một khoá khác để mã hoá CMEK.

• Dấu thời gian có mức độ chi tiết là một phút và chỉ định một thời điểm trong quá khứ, trong khoảng thời gian được xác định bằng khoảng thời gian PITR:

  • Nếu bạn bật tính năng PITR cho cơ sở dữ liệu của mình, bạn có thể chọn bất kỳ phút nào trong 7 ngày qua (hoặc ít hơn nếu bạn bật tính năng PITR chưa đến 7 ngày trước).
  • Nếu chưa bật tính năng PITR, bạn có thể chọn bất kỳ phút nào trong giờ vừa qua.
  • Bạn có thể kiểm tra dấu thời gian sớm nhất mà bạn có thể chọn trong phần mô tả của cơ sở dữ liệu.

gcloud firestore databases clone \
--source-database='SOURCE_DATABASE' \
--snapshot-time='PITR_TIMESTAMP' \
--destination-database='DESTINATION_DATABASE_ID'

gcloud firestore databases clone \
--source-database='projects/example-project/databases/(default)' \
--snapshot-time='2025-06-01T10:20:00.00Z' \
--destination-database='example-dest-db'

gcloud firestore databases clone \
--source-database='projects/example-project/databases/(default)' \
--snapshot-time='2025-06-01T10:20:00.00Z' \
--destination-database='example-dest-db'

gcloud firestore databases clone \
--source-database='projects/example-project/databases/(default)' \
--snapshot-time='2025-06-01T10:20:00.00Z' \
--destination-database='example-dest-db' \
--encryption-type='customer-managed-encryption' \
--kms-key-name='projects/example-project/locations/us-central1/keyRings/example-key-ring/cryptoKeys/example-key'

firebase firestore:databases:clone \
'SOURCE_DATABASE' \
'DESTINATION_DATABASE' \
--snapshot-time 'PITR_TIMESTAMP'

Định cấu hình quyền truy cập cho từng cơ sở dữ liệu

Bạn có thể sử dụng Điều kiện quản lý danh tính và quyền truy cập để định cấu hình quyền truy cập ở cấp độ từng cơ sở dữ liệu. Các ví dụ sau đây sử dụng Google Cloud CLI để chỉ định quyền truy cập có điều kiện cho một hoặc nhiều cơ sở dữ liệu. Bạn cũng có thể xác định các điều kiện IAM trong Google Cloud Console.

Xem các chính sách IAM hiện có

gcloud projects get-iam-policy PROJECT_ID

Đặt PROJECT_ID thành mã dự án của bạn.

Cấp quyền truy cập vào cơ sở dữ liệu

gcloud projects add-iam-policy-binding PROJECT_ID \
--member='user:EMAIL' \
--role='roles/datastore.user' \
--condition='expression=resource.name=="projects/PROJECT_ID/databases/DATABASE_ID",title=TITLE,description=DESCRIPTION'

Đặt các giá trị sau:

• PROJECT_ID: mã dự án của bạn
• EMAIL: địa chỉ email đại diện cho một Tài khoản Google cụ thể. Ví dụ: alice@example.com.
• DATABASE_ID: mã nhận dạng cơ sở dữ liệu.
• TITLE: tiêu đề không bắt buộc cho biểu thức.
• DESCRIPTION: nội dung mô tả không bắt buộc về biểu thức.

Cấp quyền truy cập vào tất cả cơ sở dữ liệu, ngoại trừ một cơ sở dữ liệu

gcloud projects add-iam-policy-binding PROJECT_ID \
--member='user:EMAIL' \
--role='roles/datastore.user' \
--condition='expression=resource.name!="projects/PROJECT_ID/databases/DATABASE_ID",title=TITLE,description=DESCRIPTION'

Đặt các giá trị sau:

• PROJECT_ID: mã dự án của bạn
• EMAIL: địa chỉ email đại diện cho một Tài khoản Google cụ thể. Ví dụ: alice@example.com.
• DATABASE_ID: mã nhận dạng cơ sở dữ liệu.
• TITLE: tiêu đề không bắt buộc cho biểu thức.
• DESCRIPTION: nội dung mô tả không bắt buộc về biểu thức.

Xoá chính sách cho một thành viên và vai trò nhất định

gcloud projects remove-iam-policy-binding PROJECT_ID \
--member='user:EMAIL' \
--role='roles/datastore.user' --all

Đặt các giá trị sau:

• PROJECT_ID: mã dự án của bạn
• EMAIL: địa chỉ email đại diện cho một Tài khoản Google cụ thể. Ví dụ: alice@example.com.

Cloud Monitoring

Cloud Firestore chỉ số được báo cáo trong hai tài nguyên được theo dõi.

• firestore.googleapis.com/Database
• firestore_instance(Cũ)

Bạn có thể kiểm tra các chỉ số tổng hợp ở cấp cơ sở dữ liệu bằng cách xem firestore.googleapis.com/Database. Các chỉ số được báo cáo trong firestore_instance được tổng hợp ở cấp dự án.

Hạn chế

• Bạn có thể có tối đa 100 cơ sở dữ liệu cho mỗi dự án. Bạn có thể liên hệ với nhóm hỗ trợ để yêu cầu tăng hạn mức này.
• Bạn không thể xoá cơ sở dữ liệu (default) nếu cơ sở dữ liệu đó chứa bất kỳ dữ liệu tìm kiếm GAE nào. Sử dụng API xoá chỉ mục để xoá dữ liệu tìm kiếm trên GAE. Nếu gần đây bạn đã xoá dữ liệu GAE Search, thì có thể bạn sẽ phải chờ một khoảng thời gian trước khi có thể xoá cơ sở dữ liệu.
• Bạn không thể xoá cơ sở dữ liệu (default) nếu cơ sở dữ liệu đó chứa bất kỳ thực thể blob nào. Sử dụng API xoá Blobstore để xoá dữ liệu Blobstore. Bạn có thể kiểm tra xem cơ sở dữ liệu (default) của mình có dữ liệu Blobstore hay không bằng cách chạy truy vấn GQL sau trong Google Cloud Console: SELECT * FROM __BlobInfo__.
• Bạn không thể sử dụng lại mã nhận dạng cơ sở dữ liệu cho đến khi hết 5 phút sau khi xoá.
• Cloud Functions phiên bản 1 không hỗ trợ Cơ sở dữ liệu có tên trong Firestore. Sử dụng Trình kích hoạt Cloud Firestore (thế hệ thứ 2) để định cấu hình sự kiện cho các cơ sở dữ liệu được đặt tên.
• Trình kích hoạt hàm Firestore phiên bản 1 và Trình kích hoạt sự kiện Firestore có thể ngừng hoạt động sau khi cơ sở dữ liệu bị xoá, ngay cả khi cơ sở dữ liệu mới được tạo có cùng tên.

Bước tiếp theo

• Thêm dữ liệu
• Lấy dữ liệu
• Xoá dữ liệu