如要將資料從 Firestore Standard 版資料庫遷移至 Firestore Enterprise 版資料庫,建議您使用下列其中一種方法:
匯入和匯出功能。匯入作業的資料檔案與 Enterprise 版和 Standard 版相容。
firestore-to-firestoreDataflow 範本。Dataflow 服務可讓您建構資料管道,而firestore-to-firestore範本則會在 Cloud Firestore 資料庫之間建立批次管道。
匯入和匯出是較簡單的選項,設定選項較少。
Dataflow 範本可自訂更多項目。您可以擴充範本程式碼,執行部分遷移或轉換資料。您也可以控管 worker 數量和大小。
這兩種選項都支援跨專案和區域遷移。
透過匯出和匯入功能遷移資料
如要透過匯出和匯入作業遷移資料,請參閱「匯出及匯入資料」。如要將資料移至其他專案中的資料庫,請參閱「在專案之間移動資料」。
使用 Dataflow 範本遷移資料
請按照下列操作說明,使用 firestore-to-firestore Dataflow 範本遷移資料。
事前準備
開始遷移資料前,請確認來源資料庫已啟用時間點復原 (PITR)。Dataflow 工作會使用 PITR,在 PITR 時間戳記讀取資料。如果停用 PITR,執行時間超過一小時的工作就會失敗。
必須啟用
datastore.googleapis.comAPI,才能使用這個範本。指派下一節所述的必要角色。
必要的角色
如要將資料從一個資料庫遷移至另一個資料庫,請指派下列角色。您或許也能透過自訂角色或其他預先定義的角色,取得必要權限:
- 如要取得建立新資料庫及存取 Cloud Firestore 資料所需的權限,請要求管理員授予您專案的 Cloud Datastore 擁有者 (
roles/datastore.owner) Identity and Access Management (IAM) 角色。 -
如要授予 Dataflow 工作對 Cloud Firestore 資料庫的讀取和寫入權限,請將專案的 Cloud Datastore 使用者 (
roles/datastore.user) IAM 角色指派給 Dataflow worker 服務帳戶 (例如PROJECT_NUMBER-compute@)。如要進一步瞭解 Dataflow 安全性,請參閱「Dataflow 安全性與權限」。
如要進一步瞭解如何授予 IAM 角色,請參閱「管理專案、資料夾和組織的存取權」。
1. 建立新的 Firestore Enterprise 版資料庫
如要將資料從 Standard 版資料庫遷移至 Enterprise 版資料庫,必須先建立 Enterprise 版目的地資料庫。請參閱「建立資料庫」。
2. 執行 Dataflow firestore-to-firestore 範本
使用 firestore-to-firestore 範本設定及執行 Dataflow 工作。範本支援遷移整個資料庫,或只遷移指定的集合群組。
限制
請注意 firestore-to-firestore Dataflow 範本的下列限制:
- 來源資料庫必須是 Standard 版本資料庫。
- 遷移作業會在特定讀取時間讀取資料。建議您在來源資料庫中啟用時間點復原 (PITR)。如果未啟用 PITR,資料會在 1 小時後到期,可能不足以完成資料遷移。PITR 會將資料保留期限延長至七天。
- 索引不會遷移。
Dataflow 工作不會遷移資料庫設定,例如存留時間 (TTL) 政策、備份、PITR 和客戶自行管理的加密金鑰 (CMEK)。
您必須在新資料庫中設定這些設定。為加快資料遷移速度,請等到遷移完成後,再設定目的地資料庫的存留時間、備份和時間點復原功能。
下列範例說明如何使用 Google Cloud CLI 執行範本。
遷移所有資料
如要遷移所有資料,請使用下列指令:
gcloud dataflow flex-template run "JOB_NAME" \ --project "PROJECT" \ --template-file-gcs-location gs://dataflow-templates-REGION_NAME/VERSION/flex/Cloud_Firestore_to_Firestore \ --region REGION_NAME \ --parameters "sourceProjectId=SOURCE_PROJECT_ID" \ --parameters "sourceDatabaseId=SOURCE_DATABASE_ID" \ --parameters "destinationProjectId=DESTINATION_PROJECT_ID" \ --parameters "destinationDatabaseId=DESTINATION_DATABASE_ID" \ --parameters "readTime=READ_TIME"
更改下列內容:
JOB_NAME:工作名稱。PROJECT:Google Cloud 專案的 ID。REGION_NAME:要執行 Dataflow 工作的Google Cloud位置。請使用靠近資料庫的位置。VERSION:您要使用的範本版本。您可以使用下列值:latest,使用範本的最新版本,該版本位於 bucket 中非依日期命名的上層資料夾:gs://dataflow-templates-REGION_NAME/latest/- 版本名稱,例如
2023-09-12-00_RC00,可使用特定版本的範本,該範本會以巢狀結構存放在 bucket 中相應的依日期命名上層資料夾中:gs://dataflow-templates-REGION_NAME/
SOURCE_PROJECT_ID:來源 Google Cloud 專案的 ID,其中包含 Firestore Standard 版資料庫。SOURCE_DATABASE_ID:來源 Cloud Firestore 資料庫的 ID。Cloud Firestore 資料庫新目的地的 Google Cloud 專案 ID。
DESTINATION_PROJECT_IDDESTINATION_DATABASE_ID:目的地 Cloud Firestore 資料庫的 ID。READ_TIME:從來源資料庫讀取資料的時間戳記。請將時間戳記設為 RFC 3339 格式,精細程度為分鐘,例如2026-05-15T16:31:00.00Z。最早的有效時間戳記取決於時間點復原 (PITR) 設定。請參閱「取得最早版本時間」。
遷移指定的集合群組
如要只遷移特定集合群組,請使用下列指令:
gcloud dataflow jobs run "JOB_NAME" \ --project "PROJECT" \ --gcs-location gs://dataflow-templates-REGION_NAME/VERSION/Cloud_Firestore_to_Firestore \ --region REGION_NAME \ --parameters "sourceProjectId=SOURCE_PROJECT_ID" \ --parameters "sourceDatabaseId=SOURCE_DATABASE_ID" \ --parameters "collectionGroupIds=COLLECTION_GROUP_IDS" \ --parameters "destinationProjectId=DESTINATION_PROJECT_ID" \ --parameters "destinationDatabaseId=DESTINATION_DATABASE_ID" \ --parameters "readTime=READ_TIME"
更改下列內容:
JOB_NAME:工作名稱。PROJECT:Google Cloud 專案的 ID。REGION_NAME:要執行 Dataflow 工作的Google Cloud位置。請使用靠近資料庫的位置。VERSION:您要使用的範本版本。您可以使用下列值:latest,使用範本的最新版本,該版本位於 bucket 中非依日期命名的上層資料夾:gs://dataflow-templates-REGION_NAME/latest/- 版本名稱,例如
2023-09-12-00_RC00,可使用特定版本的範本,該範本會以巢狀結構存放在 bucket 中相應的依日期命名上層資料夾中:gs://dataflow-templates-REGION_NAME/
SOURCE_PROJECT_ID:含有 Firestore 標準版資料庫的來源 Google Cloud 專案 ID。SOURCE_DATABASE_ID:來源 Cloud Firestore 資料庫的 ID。COLLECTION_GROUP_IDS:以半形逗號分隔的清單,列出要遷移的集合群組 ID。子集合不會以遞迴方式納入。舉例來說,如果您指定
users集合群組,則遷移作業不會包含/users/userid/messages的messages子集合,除非您也指定messages集合群組。Cloud Firestore 資料庫新目的地的 Google Cloud 專案 ID。
DESTINATION_PROJECT_IDDESTINATION_DATABASE_ID:目的地 Cloud Firestore 資料庫的 ID。READ_TIME:從來源資料庫讀取資料的時間戳記。請設為 RFC 3339 格式的時間戳記,精細程度為分鐘,例如2026-05-15T16:31:00.00Z。最早的有效時間戳記取決於時間點復原 (PITR) 設定。請參閱「取得最早版本時間」。
3. 設定資料庫
firestore-to-firestore 工作只會遷移資料。索引和其他資料庫設定不會遷移。除了遷移資料外,也請考慮在新資料庫中設定下列項目:
索引:Firestore Enterprise 版資料庫不一定要建立索引才能執行查詢,且預設不會自動建立索引。請參閱下列內容,瞭解如何為查詢建立索引:
- Firestore Enterprise 版索引總覽。
- 使用索引盡可能提高查詢效能。
- 您可以使用 Firebase CLI 匯出索引並部署至新資料庫。
- 使用查詢洞察,找出可透過索引最佳化的查詢。
TTL:建立 TTL 政策。
備份:設定備份。
PITR:啟用 PITR。
設定資料庫後,您可以使用新資料庫繼續測試應用程式。如要完成遷移,請更新應用程式,改用新資料庫。
疑難排解
如果資料庫很大,工作可能會因為一次讀取太多資料而失敗。解決方式:
提高
maxNumWorkers值。
後續步驟
- 瞭解如何使用管道作業查詢資料。
- 瞭解如何在 Firestore Enterprise 版中最佳化查詢
- 瞭解 Enterprise 版資料庫如何擴充。