移行ジョブを昇格させる

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

移行ジョブを昇格させる手順は次のとおりです。

1. プロモーションを開始します。データの損失を回避するため、移行元データベースへのすべての書き込み、実行中のスクリプト、クライアント接続を停止してください。休息時間の開始時間
2. トランザクション ログ ファイルから使用可能なデータがすべて Cloud SQL for SQL Server の宛先インスタンスに複製されていることを確認します。

   この結果を実現するには、次のいずれかの操作を行います。

   • 自動バックアップ ファイルのアップロードを停止するか、最後のトランザクション ログ ファイルをアップロードします。 未処理のトランザクション ログ バックアップのサイズをモニタリングして、Database Migration Service がそのファイルの処理を完了したタイミングを確認します。
   • 必要に応じて、名前が .trn.final 接尾辞で終わるトランザクション ログファイルをアップロードできます。Database Migration Service は、名前が .trn.final 接尾辞の規則に一致するバックアップ ファイルを検出すると、継続的な読み込みを停止します。

     Database Migration Service がそのファイルの処理を完了すると、移行ジョブのステータスは Ready to promote に変わります。

3. 移行ジョブに対して昇格アクションを実行します。

   コンソール

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

      [移行ジョブ] に移動

   2. [ジョブ] タブで、昇格する移行ジョブの表示名をクリックします。

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

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

   gcloud

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

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

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

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

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

   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

   結果

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

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