移行ジョブを昇格させる

継続的な移行の場合、読み取りと書き込みを移行先データベースに移動するタイミングになったら、プロモーション プロセスを開始できます。プロモーションとは、移行された Cloud SQL データベースがすべての読み取りと書き込みオペレーションにアクセスできるようになることを意味します。

移行ジョブをプロモートすることも、移行ジョブから選択したデータベースをプロモートすることもできます。

  1. 移行元データベースに対する書き込み、実行中のスクリプト、クライアント接続をすべて停止します。この時点からがダウンタイム期間となります。
  2. トランザクション ログファイルから利用可能なすべてのデータが Cloud SQL 移行先インスタンスに複製されていることを確認します。
  3. レプリケーション遅延指標がゼロまたはゼロに近くなるまで待ちます。これは、移行ジョブで未処理の変更がすべて処理されたことを意味します。

    レプリケーションの遅延がゼロでない場合でも、移行をプロモートできます。これにより、データベースのダウンタイムを短縮できますが、宛先のデータの精度に影響する可能性があります。

  4. プロモート アクションを実行します。

    コンソール

    1. Google Cloud コンソールで、[移行ジョブ] ページに移動します。

      [移行ジョブ] に移動する

    2. [ジョブ] タブで、プロモートする移行ジョブの表示名をクリックします。

      3. [移行ジョブの詳細] ページが開きます。

    3. 次のいずれかのプロモート操作を行います。

      • 移行に含まれるすべてのデータベースをプロモートする場合は、移行ジョブのツールバーで [プロモート] をクリックします。

        [移行ジョブをプロモート] ダイアログが表示されます。

      • 特定のデータベースのみをプロモートする場合は、データベース名の横にあるチェックボックスを使用してデータベースを選択し、[データベース] タブで [プロモート] をクリックします。

        プロモートするデータベースの数を示すダイアログが表示されます。

    4. ダイアログにエラーが表示されていないことを確認し、[プロモート] をクリックします。

    gcloud

    後述のコマンドデータを使用する前に、次のように置き換えます。

    • MIGRATION_JOB_ID は、移行ジョブ ID に置き換えます。

      識別子がわからない場合は、 gcloud database-migration migration-jobs list コマンドを使用して、特定のリージョン内のすべての移行ジョブを一覧表示し、その識別子を確認できます。

    • REGION は、接続プロファイルが保存されているリージョンの識別子に置き換えます。

    次のコマンドを実行します。

    Linux、macOS、Cloud Shell

    gcloud database-migration migration-jobs \
promote MIGRATION_JOB_ID \
  --region=REGION

    Windows（PowerShell）

    gcloud database-migration migration-jobs `
promote MIGRATION_JOB_ID `
  --region=REGION

    Windows（cmd.exe）

    gcloud database-migration migration-jobs ^
promote MIGRATION_JOB_ID ^
  --region=REGION

    結果

    このアクションは非同期で実行されます。そのため、このコマンドは、長時間実行オペレーションを表す Operation エンティティを返します。

    done: false
metadata:
  '@type': type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata
  apiVersion: v1
  createTime: '2024-02-20T12:20:24.493106418Z'
  requestedCancellation: false
  target: MIGRATION_JOB_ID
  verb: start
name: OPERATION_ID

    オペレーションが成功したかどうかを確認するには、返されたオペレーション オブジェクトをクエリするか、移行ジョブのステータスを確認します。
  5. 選択した移行先インスタンスまたはデータベースがプロモートされ、移行されたデータベースですべての読み取りオペレーションと書き込みオペレーションにアクセスできるようになりました。移行ジョブのステータスが Completed に変わります。
  6. これで、アプリケーションを Cloud SQL インスタンスに接続し、移行ジョブを安全に削除できるようになりました。

次のステップ