移行ジョブを昇格させる

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

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

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

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

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

     Database Migration Service がそのファイルの処理を完了すると、移行ジョブのステータスが プロモートの準備完了に変わります。

3. 昇格アクションを実行します。

   コンソール

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

      移行ジョブに移動する

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

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

   3. 次のいずれかの昇格アクションを実行します。

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

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

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

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

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

   gcloud

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

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

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

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

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

     例: --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

   結果

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

   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 インスタンスに接続できるようになり、移行ジョブを安全に削除できます。