Standard エディションから Enterprise エディションに移行する

Firestore Standard エディションのデータベースから Firestore Enterprise エディションのデータベースにデータを移行するには、次のいずれかのオプションを使用することをおすすめします。

  • インポートとエクスポートの機能。インポート オペレーションのデータファイルは、Enterprise エディションと Standard エディションの両方に対応しています。

  • firestore-to-firestore Dataflow テンプレート。Dataflow サービスを使用すると、データ パイプラインを構築できます。firestore-to-firestore テンプレートは、Cloud Firestore データベース間にバッチ パイプラインを作成します。

インポートとエクスポートは、構成オプションが少なく、簡単に実行できるオプションです。

Dataflow テンプレートは、よりカスタマイズ可能です。テンプレート コードを拡張して、部分的な移行やデータの変換を行うことができます。ワーカーの数とサイズを制御することもできます。

どちらのオプションも、プロジェクト間およびリージョン間の移行をサポートしています。

エクスポートとインポートを使用してデータを移行する

エクスポートとインポートのオペレーションでデータを移行するには、データのエクスポートとインポートをご覧ください。別のプロジェクトのデータベースにデータを移動するには、プロジェクト間でデータを移動するをご覧ください。

Dataflow テンプレートを使用してデータを移行する

firestore-to-firestore Dataflow テンプレートを使用してデータを移行する手順は次のとおりです。

始める前に

  1. データ移行を開始する前に、ソース データベースでポイントインタイム リカバリ(PITR)が有効になっていることを確認します。Dataflow ジョブは、PITR を使用して PITR タイムスタンプでデータを読み取ります。PITR が無効になっている場合、ジョブの実行時間が 1 時間を超えるとジョブは失敗します。

  2. このテンプレートを使用するには、datastore.googleapis.com API を有効にする必要があります。

  3. 次のセクションで説明する必要なロールを割り当てます。

必要なロール

1 つのデータベースから別のデータベースにデータを移行するには、次のロールを割り当てます。必要な権限は、カスタムロールや他の事前定義ロールから取得することもできます。

  1. 新しいデータベースを作成して Cloud Firestore データにアクセスするために必要な権限を取得するには、プロジェクトに対する Cloud Datastore オーナー(roles/datastore.owner)Identity and Access Management(IAM)ロールを付与するよう管理者に依頼してください。
  2. Dataflow ジョブに Cloud Firestore データベースへの読み取り / 書き込みアクセス権を付与するには、Dataflow ワーカー サービス アカウント(PROJECT_NUMBER-compute@ など)に、プロジェクトに対する Cloud Datastore ユーザー(roles/datastore.user)IAM ロールを割り当てます。

    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 を使用すると、データの保持期間が 7 日間に延長されます。
  • インデックスは移行されません。
  • Dataflow ジョブは、有効期間(TTL)ポリシー、バックアップ、PITR、顧客管理の暗号鍵(CMEK)などのデータベース構成を移行しません。

    これらの設定は、新しいデータベースで構成する必要があります。データ移行の速度を向上させるには、移行が完了するまで待ってから、移行先データベースで TTL、バックアップ、PITR を構成します。

次の例は、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: 最新バージョンのテンプレートを使用します。このテンプレートは、バケット内の日付のない親フォルダ(gs://dataflow-templates-REGION_NAME/latest/)にあります。
    • バージョン名(例: 2023-09-12-00_RC00)。特定のバージョンのテンプレートを使用します。このテンプレートは、バケット内の対応する日付の親フォルダ(gs://dataflow-templates-REGION_NAME/)にあります。
  • SOURCE_PROJECT_ID: Firestore スタンダード エディション データベースを含むソース Google Cloud プロジェクトの ID。

  • SOURCE_DATABASE_ID: ソース Cloud Firestore データベースの ID。

  • DESTINATION_PROJECT_ID: 新しい Cloud Firestore データベースの宛先 Google Cloud プロジェクトの 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: 使用するテンプレートのバージョン。使用できる値は次のとおりです。

    • latest: 最新バージョンのテンプレートを使用します。このテンプレートは、バケット内の日付のない親フォルダ(gs://dataflow-templates-REGION_NAME/latest/)にあります。
    • バージョン名(例: 2023-09-12-00_RC00)。特定のバージョンのテンプレートを使用します。このテンプレートは、バケット内の対応する日付の親フォルダ(gs://dataflow-templates-REGION_NAME/)にあります。
  • SOURCE_PROJECT_ID: Firestore Standard エディション データベースを含むソース Google Cloud プロジェクトの ID。

  • SOURCE_DATABASE_ID: ソース Cloud Firestore データベースの ID。

  • COLLECTION_GROUP_IDS: 移行するコレクション グループ ID のカンマ区切りリスト。

    サブコレクションは再帰的に含まれません。たとえば、users コレクション グループを指定した場合、messages コレクション グループも指定しない限り、移行には /users/userid/messages の messages サブコレクションは含まれません。

  • DESTINATION_PROJECT_ID: 新しい Cloud Firestore データベースの宛先 Google Cloud プロジェクトの ID。

  • DESTINATION_DATABASE_ID: 宛先 Cloud Firestore データベースの ID。

  • READ_TIME: ソース データベースからデータを読み取るタイムスタンプ。RFC 3339 形式のタイムスタンプに設定します。分単位(2026-05-15T16:31:00.00Z など)で指定します。

    有効な最も古いタイムスタンプは、ポイントインタイム リカバリ(PITR)の設定によって異なります。最も古いバージョンの時刻を取得するをご覧ください。

3. データベースを構成する

firestore-to-firestore ジョブはデータのみを移行します。インデックスやその他のデータベース設定は移行されません。データを移行するだけでなく、新しいデータベースで次の構成を検討してください。

データベースを構成したら、新しいデータベースでアプリのテストを続行できます。移行を完了するには、新しいデータベースを使用するようにアプリケーションを更新します。

トラブルシューティング

大規模なデータベースの場合、一度に大量のデータを読み取るとジョブが失敗することがあります。この問題を解決するには:

次のステップ