移行の最終処理を行う

継続的な移行の場合は、読み取りと書き込みを移行先データベースに移動するタイミングになったら、プロモーション プロセスを開始できます。 プロモーションとは、Database Migration Service が移行元データベースから切断され、変更データ イベントの移行先データベースへのレプリケーションが停止し、一時的な移行データがすべてクリーンアップされることを意味します。

1. 省略可: 移行データの完全性を確認します。
2. 移行元データベースへの書き込み、実行中のスクリプト、クライアント接続をすべて停止します。 ここからダウンタイムが始まります。
3. レプリケーション遅延指標をモニタリングし、大幅に減少するまで待ちます。理想的には数分または数秒です。
4. 移行ジョブに対してプロモート アクションを実行します。

   コンソール

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

      移行ジョブに移動する

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

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

   3. [プロモート] をクリックします。
   4. ダイアログで [プロモート] をクリックします。

   gcloud

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

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

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

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

   • 省略可: Database Migration Service は、デフォルトで移行元のすべてのデータベースを移行します。特定のデータベースのみを移行する場合は、 --databases-filter フラグを使用して、ID をカンマ区切りのリストとして指定します。

     例: --databases-filter=my-business-database,my-other-database

     --database-filter flag で作成した移行ジョブは、後で gcloud database-migration migration-jobs update コマンドを使用して編集できます。

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

   Linux、macOS、Cloud Shell

   注: 認証とプロジェクトを使用して Google Cloud CLI を初期化するには、gcloud init、gcloud auth login、または gcloud config set project のいずれかを実行します。

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

   Windows（PowerShell）

   注: 認証とプロジェクトを使用して Google Cloud CLI を初期化するには、gcloud init、gcloud auth login、または gcloud config set project のいずれかを実行します。

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

   Windows（cmd.exe）

   注: 認証とプロジェクトを使用して Google Cloud CLI を初期化するには、 gcloud init、 または gcloud auth login と gcloud config set project のいずれかを実行します。

   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
   

   オペレーションが成功したかどうかを確認するには、返されたオペレーション オブジェクトをクエリするか、移行ジョブのステータスを確認します。

   • gcloud database-migration migration-jobs describe コマンドを使用して、移行ジョブのステータスを表示します。
   • gcloud database-migration operations describe を指定して OPERATION_ID を使用すると、オペレーション自体のステータスを確認できます。
5. 移行先インスタンスがプロモートされ、移行したデータベースにすべての読み取り / 書き込みオペレーションでアクセスできるようになります。移行ジョブのステータスが Completed に変わります。
6. これで、アプリケーションを Cloud SQL インスタンスに接続し、 移行ジョブを安全に削除できます。