Sao lưu và khôi phục dữ liệu

Trang này mô tả cách sử dụng tính năng sao lưu theo lịch của Cloud Firestore. Sử dụng bản sao lưu để bảo vệ dữ liệu của bạn khỏi tình trạng hỏng dữ liệu ở cấp ứng dụng hoặc do vô tình xoá dữ liệu.

Tính năng sao lưu cho phép bạn định cấu hình lịch sao lưu để sao lưu cơ sở dữ liệu đã chỉ định hằng ngày hoặc hằng tuần. Sau đó, bạn có thể sử dụng các bản sao lưu này để khôi phục dữ liệu vào một cơ sở dữ liệu mới.

Giới thiệu về bản sao lưu

Bản sao lưu là một bản sao nhất quán của cơ sở dữ liệu tại một thời điểm. Bản sao lưu chứa tất cả dữ liệu và cấu hình chỉ mục tại thời điểm đó. Bản sao lưu không chứa các chính sách về thời gian tồn tại trong cơ sở dữ liệu. Bản sao lưu nằm ở cùng vị trí với cơ sở dữ liệu nguồn.

Bản sao lưu có thời hạn lưu giữ có thể định cấu hình và được lưu trữ cho đến khi thời hạn lưu giữ kết thúc hoặc cho đến khi bạn xoá bản sao lưu. Việc xoá cơ sở dữ liệu nguồn không tự động xoá các bản sao lưu liên quan.

Cloud Firestore lưu trữ siêu dữ liệu liên quan đến các bản sao lưu và lịch sao lưu liên quan đến một cơ sở dữ liệu. Cloud Firestore giữ lại siêu dữ liệu này cho đến khi tất cả bản sao lưu cho cơ sở dữ liệu hết hạn hoặc bị xoá.

Việc tạo hoặc giữ lại bản sao lưu không ảnh hưởng đến hiệu suất đọc hoặc ghi trong cơ sở dữ liệu trực tiếp của bạn.

Chi phí

Khi sử dụng tính năng sao lưu, bạn sẽ phải trả phí cho những khoản sau:

• Dung lượng lưu trữ mà mỗi bản sao lưu sử dụng.
• Đối với thao tác khôi phục, bạn sẽ bị tính phí dựa trên kích thước của bản sao lưu.

Để biết thêm thông tin chi tiết và mức giá chính xác, hãy xem trang Giá.

Trước khi bắt đầu

Tính năng này yêu cầu gói giá Blaze.

Vai trò bắt buộc

Để có các quyền cần thiết để quản lý bản sao lưu và lịch sao lưu, hãy yêu cầu quản trị viên cấp cho bạn một hoặc nhiều vai trò sau trong tính năng Quản lý danh tính và quyền truy cập:

• roles/datastore.owner: Quyền truy cập đầy đủ vào cơ sở dữ liệu Cloud Firestore

• Các vai trò sau đây cũng có nhưng không xuất hiện trong Google Cloud Console. Sử dụng Google Cloud CLI để chỉ định các vai trò sau:

  • roles/datastore.backupsAdmin: Quyền đọc và ghi vào bản sao lưu
  • roles/datastore.backupsViewer: Quyền đọc đối với bản sao lưu
  • roles/datastore.backupSchedulesAdmin: Quyền đọc và ghi vào lịch sao lưu
  • roles/datastore.backupSchedulesViewer: Quyền đọc lịch sao lưu
  • roles/datastore.restoreAdmin: Quyền bắt đầu các thao tác khôi phục

Tạo và quản lý lịch sao lưu

Các ví dụ dưới đây minh hoạ cách thiết lập lịch sao lưu. Đối với mỗi cơ sở dữ liệu, bạn có thể định cấu hình tối đa 1 lịch sao lưu hằng ngày và tối đa 1 lịch sao lưu hằng tuần. Bạn không thể định cấu hình nhiều lịch sao lưu hằng tuần cho các ngày trong tuần.

Bạn không thể định cấu hình thời gian chính xác trong ngày sao lưu. Quá trình sao lưu diễn ra vào nhiều thời điểm trong ngày. Đối với lịch sao lưu hằng tuần, bạn có thể định cấu hình ngày trong tuần để sao lưu.

Tạo lịch sao lưu

Để tạo lịch sao lưu cho cơ sở dữ liệu, hãy sử dụng lệnh gcloud firestore backups schedules create hoặc lệnh firebase firestore:databases:backups:schedules.

Tạo lịch sao lưu hằng ngày

gcloud

Để tạo lịch sao lưu hằng ngày, hãy đặt cờ --recurrence thành daily:

gcloud firestore backups schedules create \
--database='DATABASE_ID' \
--recurrence=daily \
--retention=RETENTION_PERIOD

Thay thế nội dung sau:

• DATABASE_ID: Mã nhận dạng của cơ sở dữ liệu cần sao lưu. Đặt thành '(default)' cho cơ sở dữ liệu mặc định.
• RETENTION_PERIOD: Đặt giá trị này thành tối đa 14 tuần (14w).

Giao diện dòng lệnh (CLI) của Firebase

Để tạo lịch sao lưu hằng ngày, hãy đặt cờ --recurrence thành DAILY:

firebase firestore:backups:schedules:create \
--database 'DATABASE_ID' \
--recurrence 'DAILY' \
--retention RETENTION_PERIOD

Thay thế nội dung sau:

• DATABASE_ID: Mã nhận dạng của cơ sở dữ liệu cần sao lưu. Đặt thành '(default)' cho cơ sở dữ liệu mặc định.
• RETENTION_PERIOD: Đặt giá trị này thành tối đa 14 tuần (14w).

Terraform

Để tạo lịch sao lưu hằng ngày, hãy tạo tài nguyên google_firestore_backup_schedule.

resource "google_firestore_backup_schedule" "daily-backup" {
  project  = PROJECT_ID
  database = DATABASE_ID

  retention = RETENTION_PERIOD_SECONDS

  daily_recurrence {}
}

Thay thế đoạn mã sau:

• PROJECT_ID: Mã nhận dạng của dự án.
• DATABASE_ID: Mã nhận dạng của cơ sở dữ liệu cần sao lưu. Đặt thành '(default)' cho cơ sở dữ liệu mặc định.
Bạn cũng có thể sử dụng thông tin tham chiếu tài nguyên đến tài nguyên Terraform thuộc loại google_firestore_database.
• RETENTION_PERIOD_SECONDS: Đặt giá trị này thành một giá trị tính bằng giây, theo sau là "s". Giá trị tối đa là 8467200s (14 tuần).

Tạo lịch sao lưu hằng tuần

gcloud

Để tạo lịch sao lưu hằng tuần, hãy đặt cờ --recurrence thành weekly:

gcloud firestore backups schedules create \
--database='DATABASE_ID' \
--recurrence=weekly \
--retention=RETENTION_PERIOD \
--day-of-week=DAY

Thay thế đoạn mã sau:

• DATABASE_ID: Mã nhận dạng của cơ sở dữ liệu cần sao lưu. Đặt thành '(default)' cho cơ sở dữ liệu mặc định.
• RETENTION_PERIOD: Đặt giá trị này thành tối đa 14 tuần (14w).
• DAY: Ngày trong tuần để bắt đầu sao lưu. Đặt thành một trong những giá trị sau:
  • SUN đại diện cho Chủ Nhật
  • MON đại diện cho thứ Hai
  • TUE đại diện cho thứ Ba
  • WED đại diện cho thứ Tư
  • THU đại diện cho thứ Năm
  • FRI đại diện cho thứ Sáu
  • SAT đại diện cho thứ Bảy

Giao diện dòng lệnh (CLI) của Firebase

Để tạo lịch sao lưu hằng tuần, hãy đặt cờ --recurrence thành WEEKLY:

firebase firestore:backups:schedules:create \
--database 'DATABASE_ID' \
--recurrence 'WEEKLY' \
--retention RETENTION_PERIOD
--day-of-week DAY

Thay thế nội dung sau:

• DATABASE_ID: Mã nhận dạng của cơ sở dữ liệu cần sao lưu. Hãy đặt thành '(default)' cho cơ sở dữ liệu mặc định.
• RETENTION_PERIOD: Đặt giá trị này thành tối đa 14 tuần (14w).
• DAY: Ngày trong tuần để sao lưu. Đặt thành một trong những giá trị sau:
  • SUNDAY đại diện cho Chủ Nhật
  • MONDAY đại diện cho thứ Hai
  • TUESDAY đại diện cho thứ Ba
  • WEDNESDAY đại diện cho thứ Tư
  • THURSDAY đại diện cho thứ Năm
  • FRIDAY đại diện cho thứ Sáu
  • SATURDAY đại diện cho thứ Bảy

Terraform

Để tạo lịch sao lưu hằng tuần, hãy tạo tài nguyên google_firestore_backup_schedule.

resource "google_firestore_backup_schedule" "weekly-backup" {
  project  = PROJECT_ID
  database = DATABASE_ID

  retention = RETENTION_PERIOD_SECONDS

  weekly_recurrence {
    day = DAY
  }
}

Thay thế đoạn mã sau:

• PROJECT_ID: Mã nhận dạng của dự án.
• DATABASE_ID: Mã nhận dạng của cơ sở dữ liệu cần sao lưu. Đặt thành '(default)' cho cơ sở dữ liệu mặc định.
Bạn cũng có thể sử dụng thông tin tham chiếu tài nguyên đến tài nguyên Terraform thuộc loại google_firestore_database.
• RETENTION_PERIOD_SECONDS: Đặt giá trị này thành một giá trị tính bằng giây, theo sau là "s". Giá trị tối đa là 8467200s (14 tuần).
• DAY: Ngày trong tuần để bắt đầu sao lưu. Đặt thành một trong những giá trị sau:
  • SUNDAY đại diện cho Chủ Nhật
  • MONDAY đại diện cho thứ Hai
  • TUESDAY đại diện cho thứ Ba
  • WEDNESDAY đại diện cho thứ Tư
  • THURSDAY đại diện cho thứ Năm
  • FRIDAY đại diện cho thứ Sáu
  • SATURDAY đại diện cho thứ Bảy

Liệt kê lịch sao lưu

Để liệt kê tất cả lịch sao lưu cho cơ sở dữ liệu, hãy sử dụng một trong các phương pháp sau:

gcloud

Sử dụng lệnh gcloud firestore backups schedules list.

gcloud firestore backups schedules list \
--database='DATABASE_ID'

Thay thế DATABASE_ID bằng mã nhận dạng của cơ sở dữ liệu. Sử dụng '(default)' cho cơ sở dữ liệu mặc định.

Giao diện dòng lệnh (CLI) của Firebase

Sử dụng lệnh firebase firestore:backups:schedules:list.

firebase firestore:backups:schedules:list \
--database 'DATABASE_ID'

Thay thế DATABASE_ID bằng mã nhận dạng của cơ sở dữ liệu. Sử dụng '(default)' cho cơ sở dữ liệu mặc định.

Mô tả lịch biểu sao lưu

Để truy xuất thông tin về lịch sao lưu, hãy sử dụng một trong các phương thức sau:

gcloud

Sử dụng lệnh gcloud firestore backups schedules describe:

gcloud firestore backups schedules describe \
--database='DATABASE_ID' \
--backup-schedule=BACKUP_SCHEDULE_ID

Thay thế nội dung sau:

• DATABASE_ID: Mã nhận dạng của cơ sở dữ liệu cần sao lưu. Đặt thành '(default)' cho cơ sở dữ liệu mặc định.
• BACKUP_SCHEDULE_ID: Mã của lịch biểu sao lưu. Bạn có thể xem mã nhận dạng của từng lịch sao lưu khi liệt kê tất cả lịch sao lưu.

Cập nhật lịch sao lưu

Để cập nhật khoảng thời gian lưu giữ của một lịch biểu sao lưu, hãy sử dụng một trong các phương pháp sau:

gcloud

Sử dụng lệnh gcloud firestore backups schedules update:

gcloud firestore backups schedules update \
--database='DATABASE_ID' \
--backup-schedule=BACKUP_SCHEDULE_ID \
--retention=RETENTION_PERIOD

Thay thế nội dung sau:

• DATABASE_ID: Mã nhận dạng của cơ sở dữ liệu cần sao lưu. Đặt thành '(default)' cho cơ sở dữ liệu mặc định.
• BACKUP_SCHEDULE_ID: Mã của lịch sao lưu. Bạn có thể xem mã nhận dạng của từng lịch sao lưu khi liệt kê tất cả lịch sao lưu.
• RETENTION_PERIOD: Đặt giá trị này thành tối đa 14 tuần (14w).

Giao diện dòng lệnh (CLI) của Firebase

Sử dụng lệnh firebase firestore:backups:schedules:update:

firebase firestore:backups:schedules:update \
BACKUP_SCHEDULE \
--retention RETENTION_PERIOD

Thay thế nội dung sau:

• BACKUP_SCHEDULE: Tên tài nguyên đầy đủ của lịch sao lưu. Bạn có thể xem tên của từng lịch sao lưu khi liệt kê tất cả lịch sao lưu.
• RETENTION_PERIOD: Đặt giá trị này thành tối đa 14 tuần (14w).

Bạn có thể cập nhật khoảng thời gian lưu giữ của lịch sao lưu, nhưng không thể cập nhật tần suất lặp lại của lịch đó. Nếu bạn cần một lịch sao lưu có tần suất lặp lại khác, hãy xoá lịch sao lưu cũ nếu không cần nữa. Sau đó, tạo một lịch biểu sao lưu mới với thời gian lặp lại mong muốn.

Xoá lịch sao lưu

Để xoá lịch sao lưu, hãy sử dụng một trong các phương thức sau:

gcloud

Sử dụng lệnh gcloud firestore backups schedules delete:

gcloud firestore backups schedules delete \
--database='DATABASE_ID' \
--backup-schedule=BACKUP_SCHEDULE_ID

Thay thế nội dung sau:

• DATABASE_ID: Mã nhận dạng của cơ sở dữ liệu cần sao lưu. Đặt thành '(default)' cho cơ sở dữ liệu mặc định.
• BACKUP_SCHEDULE_ID: Mã của lịch sao lưu. Bạn có thể xem mã nhận dạng của từng lịch sao lưu khi liệt kê tất cả lịch sao lưu.

Giao diện dòng lệnh (CLI) của Firebase

Sử dụng lệnh firebase firestore:backups:schedules:delete:

firebase firestore:backups:schedules:delete \
BACKUP_SCHEDULE

Thay thế nội dung sau:

• BACKUP_SCHEDULE: Tên tài nguyên đầy đủ của lịch sao lưu. Bạn có thể xem tên của từng lịch sao lưu khi liệt kê tất cả lịch sao lưu.

Xin lưu ý rằng việc xoá lịch sao lưu sẽ không xoá các bản sao lưu đã được tạo theo lịch này. Bạn có thể chờ các tệp này hết hạn sau khoảng thời gian lưu giữ hoặc để xoá bản sao lưu theo cách thủ công, hãy xem phần xoá bản sao lưu.

Quản lý bản sao lưu

Liệt kê bản sao lưu

Để liệt kê các bản sao lưu có sẵn, hãy sử dụng một trong các phương thức sau:

gcloud

Dùng lệnh gcloud firestore backups list:

gcloud firestore backups list \
--format="table(name, database, state)"

Cờ --format="table(name, database, state)" định dạng đầu ra thành một định dạng dễ đọc hơn. Để chỉ liệt kê các bản sao lưu từ một vị trí cụ thể, hãy sử dụng cờ --location:

gcloud firestore backups list \
--location=LOCATION \
--format="table(name, database, state)"

Thay thế LOCATION bằng tên của vị trí Cloud Firestore.

Giao diện dòng lệnh (CLI) của Firebase

Sử dụng lệnh firebase firestore:backups:list:

firebase firestore:backups:list

Để chỉ liệt kê các bản sao lưu từ một vị trí cụ thể, hãy sử dụng cờ --location:

firebase firestore:backups:list \
--location=LOCATION

Thay thế LOCATION bằng tên của vị trí Cloud Firestore.

Mô tả bản sao lưu

Để xem thông tin chi tiết về một bản sao lưu, hãy sử dụng một trong những phương thức sau:

gcloud

Sử dụng lệnh gcloud firestore backups describe:

gcloud firestore backups describe \
--location=LOCATION \
--backup=BACKUP_ID

Thay thế nội dung sau:

• LOCATION: Vị trí của cơ sở dữ liệu.
• BACKUP_ID: Mã nhận dạng bản sao lưu. Bạn có thể xem mã nhận dạng của từng bản sao lưu khi liệt kê tất cả bản sao lưu.

Giao diện dòng lệnh (CLI) của Firebase

Sử dụng lệnh firebase firestore:backups:get:

firebase firestore:backups:get BACKUP

Thay thế đoạn mã sau:

• BACKUP: Tên tài nguyên đầy đủ của bản sao lưu. Bạn có thể xem tên của từng bản sao lưu khi liệt kê tất cả bản sao lưu.

Xóa dữ liệu sao lưu

Để xoá bản sao lưu, hãy dùng một trong các phương pháp sau. Cảnh báo: Bạn không thể khôi phục bản sao lưu đã xoá.

gcloud

Sử dụng lệnh gcloud firestore backups delete:

gcloud firestore backups delete \
--location=LOCATION \
--backup=BACKUP_ID

Thay thế nội dung sau:

• LOCATION: Vị trí của cơ sở dữ liệu.
• BACKUP_ID: Mã nhận dạng bản sao lưu. Bạn có thể xem mã nhận dạng của từng bản sao lưu khi liệt kê tất cả bản sao lưu.

Giao diện dòng lệnh (CLI) của Firebase

Sử dụng lệnh firebase firestore:backups:delete:

firebase firestore:backups:delete \
BACKUP

Thay thế nội dung sau:

• BACKUP: Tên tài nguyên đầy đủ của bản sao lưu. Bạn có thể xem tên của từng bản sao lưu khi liệt kê tất cả bản sao lưu.

Lưu ý: Cloud Firestore lưu trữ siêu dữ liệu liên quan đến các bản sao lưu và lịch sao lưu liên quan đến một cơ sở dữ liệu. Cloud Firestore giữ lại siêu dữ liệu này cho đến khi tất cả bản sao lưu cho cơ sở dữ liệu hết hạn hoặc bị xoá.

Khôi phục dữ liệu từ bản sao lưu cơ sở dữ liệu

Thao tác khôi phục sẽ ghi dữ liệu từ bản sao lưu vào cơ sở dữ liệu Cloud Firestore mới.

Để bắt đầu thao tác khôi phục, hãy sử dụng một trong các phương thức sau:

gcloud

Dùng lệnh gcloud firestore databases restore:

gcloud firestore databases restore \
--source-backup=projects/PROJECT_ID/locations/LOCATION/backups/BACKUP_ID \
--destination-database='DATABASE_ID'

Thay thế nội dung sau:

• PROJECT_ID: Mã dự án của bạn.
• LOCATION: Vị trí của bản sao lưu cơ sở dữ liệu và vị trí của cơ sở dữ liệu mới được tạo cho dữ liệu được khôi phục.
• BACKUP_ID: Mã nhận dạng của bản sao lưu. Bạn có thể xem mã nhận dạng của từng bản sao lưu khi liệt kê tất cả bản sao lưu.
• DATABASE_ID: Mã nhận dạng cơ sở dữ liệu cho cơ sở dữ liệu mới. Bạn không thể sử dụng mã nhận dạng cơ sở dữ liệu đã được sử dụng.

Kết quả sẽ bao gồm các thành phần metadata, name và response:

metadata:
  '@type': type.googleapis.com/google.firestore.admin.v1.RestoreDatabaseMetadata
  backup: projects/PROJECT_ID/locations/LOCATION/backups/BACKUP_ID
  database: projects/PROJECT_ID/databases/DATABASE_ID
  operationState: PROCESSING
  progressPercentage:
    completedWork: '20'
    estimatedWork: '100'
  startTime: '2023-12-06T14:20:17.398325Z'
name: projects/PROJECT_ID/databases/DATABASE_ID/operations/operation_uuid
response:
  '@type': type.googleapis.com/google.firestore.admin.v1.Database
  createTime: '2023-12-06T14:20:17.398325Z'
  name: projects/PROJECT_ID/databases/DATABASE_ID
  ...

Trường metadata bao gồm một thành phần progressPercentage, nêu chi tiết tiến trình khôi phục ước tính cho đến thời điểm hiện tại và một operationState chỉ định trạng thái tổng thể của quá trình khôi phục. Để truy xuất lại thông tin này, hãy sử dụng gcloud firestore operations list:

gcloud firestore operations list --database=DATABASE_ID

hoặc sử dụng trường name từ kết quả được mô tả ở trên, với gcloud firestore operations describe:

gcloud firestore operations describe OPERATION_NAME

Giao diện dòng lệnh (CLI) của Firebase

Sử dụng lệnh firebase firestore:databases:restore:

firebase firestore:databases:restore \
--backup 'BACKUP' \
--database 'DATABASE_ID'

Thay thế nội dung sau:

• BACKUP: Tên tài nguyên đầy đủ của một bản sao lưu. Bạn có thể xem tên của từng bản sao lưu khi liệt kê tất cả bản sao lưu.
• DATABASE_ID: Mã cơ sở dữ liệu cho cơ sở dữ liệu mới. Bạn không thể sử dụng mã nhận dạng cơ sở dữ liệu đã được sử dụng.