本頁面說明如何使用 Cloud Firestore 排程備份功能。使用備份功能,避免應用程式層級資料毀損或意外刪除資料。
備份功能可讓您設定備份時程,每天或每週備份指定資料庫。接著,您可以使用這些備份將資料還原至新的資料庫。
備份功能簡介
備份是資料庫在某個時間點的一致副本。備份檔案會包含該時間點的所有資料和索引設定。備份不含資料庫生命週期政策。備份會儲存在與來源資料庫相同的位置。
備份有可設定的保留期限,會儲存到保留期限屆滿或您刪除備份為止。刪除來源資料庫不會自動刪除相關備份。
Cloud Firestore 會儲存與備份相關的中繼資料,以及與資料庫相關的備份時間表。Cloud Firestore 會保留這項中繼資料,直到資料庫的所有備份都過期或遭到刪除為止。
建立或保留備份不會影響您在實際資料庫中讀取或寫入的效能。
費用
使用備份功能時,系統會根據下列項目向您收費:
- 每個備份使用的儲存空間量。
- 還原作業的費用會根據備份大小計算。
如需進一步瞭解相關資訊和確切費率,請參閱「定價」頁面。
事前準備
這項功能需要Blaze 定價方案。必要的角色
如要取得管理備份和備份時間表所需的權限,請要求管理員授予您下列一或多個身分與存取權管理角色:
roles/datastore.owner
:可完全存取 Cloud Firestore 資料庫您也可以使用下列角色,但這些角色不會顯示在 Google Cloud 控制台中。使用 Google Cloud CLI 指派這些角色:
roles/datastore.backupsAdmin
:備份的讀取和寫入權限roles/datastore.backupsViewer
:備份的讀取權限roles/datastore.backupSchedulesAdmin
:備份時間表的讀取和寫入權限roles/datastore.backupSchedulesViewer
:備份排程的讀取權限roles/datastore.restoreAdmin
:啟動還原作業的權限
建立及管理備份時間表
以下範例說明如何設定備份時間表。針對每個資料庫,您最多可以設定一個每日備份時間表和一個每週備份時間表。您無法針對不同的星期設定多個每週備份時間表。
您無法設定備份的確切時間。備份作業會在每天不同的時間執行。針對每週備份排程,您可以設定星期幾要備份。
建立備份時間表
如要為資料庫建立備份排程,請使用 gcloud firestore backups schedules create
指令或 firebase firestore:databases:backups:schedules
指令。
建立每日備份排程
gcloud
如要建立每日備份時程,請將--recurrence
標記設為 daily
:
gcloud firestore backups schedules create \ --database='DATABASE_ID' \ --recurrence=daily \ --retention=RETENTION_PERIOD
更改下列內容:
- DATABASE_ID:要備份的資料庫 ID。將預設資料庫設為
'(default)'
。 - RETENTION_PERIOD:將這個值設為最多 14 週 (
14w
)。
Firebase CLI
如要建立每日備份時程,請將--recurrence
標記設為 DAILY
:
firebase firestore:backups:schedules:create \ --database 'DATABASE_ID' \ --recurrence 'DAILY' \ --retention RETENTION_PERIOD
更改下列內容:
- DATABASE_ID:要備份的資料庫 ID。將預設資料庫設為
'(default)'
。 - RETENTION_PERIOD:將這個值設為最多 14 週 (
14w
)。
Terraform
如要建立每日備份時間表,請建立google_firestore_backup_schedule
資源。resource "google_firestore_backup_schedule" "daily-backup" { project = PROJECT_ID database = DATABASE_ID retention = RETENTION_PERIOD_SECONDS daily_recurrence {} }
更改下列內容:
- PROJECT_ID:專案 ID。
- DATABASE_ID:要備份的資料庫 ID。將預設資料庫設為
'(default)'
。
您也可以使用 資源參照,指向 - RETENTION_PERIOD_SECONDS:將這個值設為以秒為單位的值,後面加上「s」。最大值為
8467200s
(14 週)。
google_firestore_database
類型的 Terraform 資源。建立每週備份時間表
gcloud
如要建立每週備份時間表,請將--recurrence
旗標設為 weekly
:
gcloud firestore backups schedules create \ --database='DATABASE_ID' \ --recurrence=weekly \ --retention=RETENTION_PERIOD \ --day-of-week=DAY請將下列項目替換為:
- DATABASE_ID:要備份的資料庫 ID。將預設資料庫設為
'(default)'
。 - RETENTION_PERIOD:將這個值設為最多 14 週 (
14w
)。 - DAY:備份的星期幾。設為下列其中一個值:
SUN
代表星期日MON
代表星期一TUE
代表星期二WED
代表星期三THU
代表星期四FRI
代表星期五SAT
代表星期六
Firebase CLI
如要建立每週備份時間表,請將--recurrence
旗標設為 WEEKLY
:
firebase firestore:backups:schedules:create \ --database 'DATABASE_ID' \ --recurrence 'WEEKLY' \ --retention RETENTION_PERIOD --day-of-week DAY請將下列項目替換為:
- DATABASE_ID:要備份的資料庫 ID。將預設資料庫設為
'(default)'
。 - RETENTION_PERIOD:將這個值設為最多 14 週 (
14w
)。 - DAY:備份的星期幾。設為下列其中一個值:
SUNDAY
代表星期日MONDAY
代表星期一TUESDAY
代表星期二WEDNESDAY
代表星期三THURSDAY
代表星期四FRIDAY
代表星期五SATURDAY
代表星期六
Terraform
如要建立每週備份時間表,請建立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 } }
更改下列內容:
- PROJECT_ID:專案 ID。
- DATABASE_ID:要備份的資料庫 ID。將預設資料庫設為
'(default)'
。
您也可以使用 資源參照,指向 - RETENTION_PERIOD_SECONDS:將這個值設為以秒為單位的值,後面加上「s」。最大值為
8467200s
(14 週)。 - DAY:備份的星期幾。設為下列其中一個值:
SUNDAY
代表星期日MONDAY
代表星期一TUESDAY
代表星期二WEDNESDAY
代表星期三THURSDAY
代表星期四FRIDAY
代表星期五SATURDAY
代表星期六
google_firestore_database
類型的 Terraform 資源。列出備份排程
如要列出資料庫的所有備份時程,請使用下列其中一種方法:
gcloud
使用gcloud firestore backups schedules list
指令。gcloud firestore backups schedules list \ --database='DATABASE_ID'請將 DATABASE_ID 替換為資料庫的 ID。使用
'(default)'
做為預設資料庫。Firebase CLI
使用firebase firestore:backups:schedules:list
指令。firebase firestore:backups:schedules:list \ --database 'DATABASE_ID'請將 DATABASE_ID 替換為資料庫的 ID。使用
'(default)'
做為預設資料庫。說明備份時程
如要擷取備份時間表的相關資訊,請使用下列其中一種方法:
gcloud
使用gcloud firestore backups schedules describe
指令:
gcloud firestore backups schedules describe \ --database='DATABASE_ID' \ --backup-schedule=BACKUP_SCHEDULE_ID取代以下內容:
- DATABASE_ID:要備份的資料庫 ID。將預設資料庫設為
'(default)'
。 - BACKUP_SCHEDULE_ID:備份時間表的 ID。列出所有備份時程時,您可以查看每個備份時程的 ID。
更新備份排程
如要更新備份排程的保留期限,請使用下列其中一種方法:
gcloud
使用gcloud firestore backups schedules update
指令:
gcloud firestore backups schedules update \ --database='DATABASE_ID' \ --backup-schedule=BACKUP_SCHEDULE_ID \ --retention=RETENTION_PERIOD取代以下內容:
- DATABASE_ID:要備份的資料庫 ID。將預設資料庫設為
'(default)'
。 - BACKUP_SCHEDULE_ID:備份時間表的 ID。列出所有備份時程時,您可以查看每個備份時程的 ID。
- RETENTION_PERIOD:將這個值設為最多 14 週 (
14w
)。
Firebase CLI
使用firebase firestore:backups:schedules:update
指令:
firebase firestore:backups:schedules:update \ BACKUP_SCHEDULE \ --retention RETENTION_PERIOD請替換下列項目:
- BACKUP_SCHEDULE:備份時間表的完整資源名稱。您可以列出所有備份排程,查看每個備份排程的名稱。
- RETENTION_PERIOD:將這個值設為最多 14 週 (
14w
)。
您可以更新備份時間表的保留期限,但無法更新週期。如果您需要採用不同週期性的備份排程,請刪除不再需要的舊備份排程,然後建立採用所需週期性的新備份排程。
刪除備份排程
如要刪除備份時間表,請使用下列任一方法:
gcloud
使用gcloud firestore backups schedules delete
指令:
gcloud firestore backups schedules delete \ --database='DATABASE_ID' \ --backup-schedule=BACKUP_SCHEDULE_ID取代以下內容:
- DATABASE_ID:要備份的資料庫 ID。將預設資料庫設為
'(default)'
。 - BACKUP_SCHEDULE_ID:備份時間表的 ID。列出所有備份時程時,您可以查看每個備份時程的 ID。
Firebase CLI
使用firebase firestore:backups:schedules:delete
指令:
firebase firestore:backups:schedules:delete \ BACKUP_SCHEDULE請替換下列項目:
- BACKUP_SCHEDULE:備份時間表的完整資源名稱。您可以列出所有備份排程,查看每個備份排程的名稱。
請注意,刪除備份排程並不會刪除此排程已建立的備份。您可以等到保留期限過後再讓備份資料過期,也可以手動刪除備份資料,請參閱「刪除備份資料」一文。
管理備份
列出備份
如要列出可用的備份,請使用下列其中一種方法:
gcloud
請使用gcloud firestore backups list
指令:
gcloud firestore backups list \ --format="table(name, database, state)"
--format="table(name, database, state)"
標記會將輸出內容格式化為更易讀的格式。
如要只列出特定位置的備份,請使用 --location
標記:
gcloud firestore backups list \ --location=LOCATION \ --format="table(name, database, state)"將
LOCATION
替換為 Cloud Firestore 位置的名稱。Firebase CLI
使用firebase firestore:backups:list
指令:
firebase firestore:backups:list如要只列出特定位置的備份,請使用
--location
標記:
firebase firestore:backups:list \ --location=LOCATION將
LOCATION
替換為 Cloud Firestore 位置的名稱。
說明備份
如要查看備份的詳細資料,請使用下列其中一種方法:
gcloud
使用gcloud firestore backups describe
指令:
gcloud firestore backups describe \ --location=LOCATION \ --backup=BACKUP_ID取代以下內容:
- LOCATION:資料庫的位置。
- BACKUP_ID:備份的 ID。列出所有備份時,您可以查看每個備份的 ID。
Firebase CLI
使用firebase firestore:backups:get
指令:
firebase firestore:backups:get BACKUP請替換下列項目:
- BACKUP:備份的完整資源名稱。列出所有備份時,您可以查看每個備份的名稱。
刪除備份
gcloud
使用gcloud firestore backups delete
指令:
gcloud firestore backups delete \ --location=LOCATION \ --backup=BACKUP_ID取代以下內容:
- LOCATION:資料庫的位置。
- BACKUP_ID:備份的 ID。列出所有備份時,您可以查看每個備份的 ID。
Firebase CLI
使用firebase firestore:backups:delete
指令:
firebase firestore:backups:delete \ BACKUP請替換下列項目:
- BACKUP:備份的完整資源名稱。您可以列出所有備份,查看每個備份的名稱。
從資料庫備份還原資料
如果執行還原作業,備份中的資料就會寫入新的 Cloud Firestore 資料庫。
如要開始還原作業,請使用下列其中一種方法:
gcloud
使用gcloud firestore databases restore
指令:
gcloud firestore databases restore \ --source-backup=projects/PROJECT_ID/locations/LOCATION/backups/BACKUP_ID \ --destination-database='DATABASE_ID'取代以下內容:
- PROJECT_ID:您的專案 ID。
- LOCATION:資料庫備份的位置,以及為復原資料建立的新資料庫的位置。
- BACKUP_ID:備份的 ID。列出所有備份時,您可以查看每個備份的 ID。
- DATABASE_ID:新資料庫的資料庫 ID。您無法使用已在使用中的資料庫 ID。
metadata
、name
和 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 ...
metadata
欄位包含 progressPercentage
元件,詳細說明目前的還原進度,以及 operationState
指定還原作業的整體狀態。
如要再次擷取這項資訊,請使用 gcloud firestore operations list
:
gcloud firestore operations list --database=DATABASE_ID或者,使用上述輸出內容中的
name
欄位,搭配 gcloud firestore operations describe
:
gcloud firestore operations describe OPERATION_NAME
Firebase CLI
使用firebase firestore:databases:restore
指令:
firebase firestore:databases:restore \ --backup 'BACKUP' \ --database 'DATABASE_ID'請替換下列項目:
- BACKUP:備份的完整資源名稱。列出所有備份時,您可以查看每個備份的名稱。
- DATABASE_ID:新資料庫的資料庫 ID。您無法使用已在使用中的資料庫 ID。