您可以使用 Cloud Firestore 代管大量刪除服務,從資料庫中刪除資料。這項功能可針對一或多個收集群組執行刪除作業。
本頁面說明如何使用代管大量刪除服務,大量刪除 Cloud Firestore 文件。您可以透過 gcloud
指令列工具和 Cloud Firestore API (REST、RPC) 使用 Cloud Firestore 代管大量刪除服務。
事前準備
您必須先完成下列步驟,才能使用代管大量刪除服務:
- 為 Google Cloud 專案啟用結帳功能。只有啟用計費功能的 Google Cloud 專案才能使用大量刪除功能。
-
確認你的帳戶具備「Cloud Firestore」的必要權限。如果您是專案擁有者,您的帳戶必須擁有必要權限。否則,下列角色可授予大量刪除作業所需的權限:
- Cloud Firestore 角色:
Owner
、Cloud Datastore Owner
或Cloud Datastore Bulk Admin
- Cloud Firestore 角色:
為專案設定 gcloud
您可以透過 Google Cloud 主控台或 gcloud
指令列工具啟動大量刪除作業。如要使用 gcloud
,請設定指令列工具,並透過下列任一方式連線至專案:
使用 Cloud Shell 從 Google Cloud 控制台存取
gcloud
。確保將
gcloud
設定為正確的專案:gcloud config set project [PROJECT_ID]
大量刪除資料
大量刪除作業會先找出資料庫中的所有適用文件,然後逐批刪除。結果可能會因進度而異,但您仍可查詢或閱讀這些文件。大量刪除作業不會刪除作業開始後新增或修改的任何文件。
大量刪除特定收集群組
gcloud
如要大量刪除特定集合群組,請使用 --collection-ids
標記。這項作業只會刪除指定 ID 的集合群組。集合群組包含所有文件和巢狀文件 (位於任何路徑),以及指定的集合群組。
gcloud beta firestore bulk-delete \ --collection-ids=[COLLECTION_GROUP_ID_1_OR_KIND_1],[COLLECTION_GROUP_ID_2_OR_KIND_2],[SUBCOLLECTION_GROUP_ID_1_OR_KIND_3] \ --database=[DATABASE]
管理大量刪除作業
開始執行大量刪除作業後,Cloud Firestore 會為作業指派不重複的名稱。您可以使用作業名稱刪除、取消或查看作業狀態。
作業名稱的前置字串為 projects/[PROJECT_ID]/databases/[DATABASE_ID]/operations/
,例如:
projects/my-project/databases/(default)/operations/ASA1MTAwNDQxNAgadGx1YWZlZAcSeWx0aGdpbi1zYm9qLW5pbWRhEgopEg
不過,您可以省略前置字串,為 describe
、cancel
和 delete
指令指定作業名稱。
列出所有大量刪除作業
gcloud
使用 operations list
指令,查看所有執行中和最近完成的作業,包括大量刪除作業:
gcloud firestore operations list
查看作業狀態
gcloud
使用 operations describe
指令顯示大量刪除作業的狀態。
gcloud firestore operations describe [OPERATION_NAME]
預估完成時間
針對長時間執行作業狀態的要求,系統會傳回 workEstimated
和 workCompleted
指標。每個指標都會以位元組數和文件數回傳:
workEstimated
會顯示作業將要處理的位元組總數和文件總數預估值。如果 Cloud Firestore 無法做出預估,可能會略過這項指標。workCompleted
會顯示目前已刪除的位元組數和文件數。作業完成後,這個值會顯示實際處理的位元組和文件總數,可能會大於workEstimated
的值。
將 workCompleted
除以 workEstimated
可得出進度的粗估值。這個預估結果可能不準確,因為這取決於延遲統計資料的收集作業。
取消作業
gcloud
使用 operations cancel
指令停止進行中的作業:
gcloud firestore operations cancel [OPERATION_NAME]
取消執行中的作業並不會撤銷該作業。已取消的大量刪除作業無法復原已刪除的文件。
刪除作業
使用 gcloud firestore operations delete
指令,即可從近期作業清單中移除已完成的作業。如要取消執行中的作業,請使用先前的取消作業。
gcloud firestore operations delete [OPERATION_NAME]
大量刪除作業的計費和定價
您必須先為 Google Cloud 專案啟用計費功能,才能使用代管大量刪除服務。
系統會依據 Cloud Firestore 定價中的費率,向您收取大量刪除作業的文件讀取和刪除費用。大量刪除作業會導致每個找到的文件讀取一個索引項目,以及每個刪除的文件執行一個刪除作業。讀取最多 1,000 個索引項目的讀取作業會收取一次費用。舉例來說,如果大量刪除作業刪除了 1, 500 份文件,您將被收取 2 次文件讀取和 1, 500 次文件刪除的費用。
請注意,Cloud Firestore 會根據實際完成的工作收費。如果作業因使用者錯誤而取消或失敗,您將根據進度付費。如果文件最終並未刪除 (例如刪除作業開始後修改的文件),Cloud Firestore 不會收取讀取或刪除文件的費用。費用會在作業完成當天計入。
大量刪除作業在完成之後,才會觸發 Google Cloud 預算快訊。同樣地,在大量刪除作業期間執行的讀取和刪除作業,會在作業完成後套用至您的免費配額/用量。大量刪除作業不會影響控制台的使用情況部分所顯示的使用量。
查看大量刪除費用
大量刪除作業會將 goog-firestoremanaged:bulkdelete
標籤套用至已結帳的作業。在 Cloud Billing 報表頁面中,您可以使用此標籤查看大量刪除作業的相關費用。
最佳做法
避免略過已刪除的資料,這可能會導致查詢速度變慢。