從 Standard 版遷移至 Enterprise 版

如要將資料從 Firestore Standard 版資料庫遷移至 Firestore Enterprise 版資料庫,建議您使用下列其中一種方法:

  • 匯入和匯出功能。匯入作業的資料檔案與 Enterprise 版和 Standard 版相容。

  • firestore-to-firestore Dataflow 範本。Dataflow 服務可讓您建構資料管道,而 firestore-to-firestore 範本則會在 Cloud Firestore 資料庫之間建立批次管道。

匯入和匯出是較簡單的選項,設定選項較少。

Dataflow 範本可自訂更多項目。您可以擴充範本程式碼,執行部分遷移或轉換資料。您也可以控管 worker 數量和大小。

這兩種選項都支援跨專案和區域遷移。

透過匯出和匯入功能遷移資料

如要透過匯出和匯入作業遷移資料,請參閱「匯出及匯入資料」。如要將資料移至其他專案中的資料庫,請參閱「在專案之間移動資料」。

使用 Dataflow 範本遷移資料

請按照下列操作說明,使用 firestore-to-firestore Dataflow 範本遷移資料。

事前準備

  1. 開始遷移資料前,請確認來源資料庫已啟用時間點復原 (PITR)。Dataflow 工作會使用 PITR,在 PITR 時間戳記讀取資料。如果停用 PITR,執行時間超過一小時的工作就會失敗。

  2. 必須啟用 datastore.googleapis.com API,才能使用這個範本。

  3. 指派下一節所述的必要角色。

必要的角色

如要將資料從一個資料庫遷移至另一個資料庫,請指派下列角色。您或許也能透過自訂角色或其他預先定義的角色,取得必要權限:

  1. 如要取得建立新資料庫及存取 Cloud Firestore 資料所需的權限,請要求管理員授予您專案的 Cloud Datastore 擁有者 (roles/datastore.owner) Identity and Access Management (IAM) 角色。
  2. 如要授予 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:您要使用的範本版本。您可以使用下列值:

  • SOURCE_PROJECT_ID:來源 Google Cloud 專案的 ID,其中包含 Firestore Standard 版資料庫。

  • SOURCE_DATABASE_ID:來源 Cloud Firestore 資料庫的 ID。

  • Cloud Firestore 資料庫新目的地的 Google Cloud 專案 ID。DESTINATION_PROJECT_ID

  • DESTINATION_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:您要使用的範本版本。您可以使用下列值:

  • 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_ID

  • DESTINATION_DATABASE_ID:目的地 Cloud Firestore 資料庫的 ID。

  • READ_TIME:從來源資料庫讀取資料的時間戳記。請設為 RFC 3339 格式的時間戳記,精細程度為分鐘,例如 2026-05-15T16:31:00.00Z。

    最早的有效時間戳記取決於時間點復原 (PITR) 設定。請參閱「取得最早版本時間」。

3. 設定資料庫

firestore-to-firestore 工作只會遷移資料。索引和其他資料庫設定不會遷移。除了遷移資料外,也請考慮在新資料庫中設定下列項目:

設定資料庫後,您可以使用新資料庫繼續測試應用程式。如要完成遷移,請更新應用程式,改用新資料庫。

疑難排解

如果資料庫很大,工作可能會因為一次讀取太多資料而失敗。解決方式:

後續步驟