移行ジョブを昇格させる

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

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

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

    Cloud SQL for SQL Server ソース

    Cloud SQL for SQL Server ソースの場合、Database Migration Service はトランザクション ログのエクスポートのモニタリングを自動的に処理します。ソース インスタンスへの書き込みを停止した後は、追加の操作を行う必要はありません。移行ジョブのプロモートを続行できます。

    セルフマネージドまたは Amazon RDS のソース

    セルフマネージド ソースまたは Amazon RDS ソースの場合、次のいずれかのアクションを実行することで、この結果を実現できます。
  3. プロモート アクションを実行します。

    コンソール

    移行ジョブは、Database Migration Service または移行先インスタンスのページからプロモートできます。

    Database Migration Service での操作:

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

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

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

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

    3. 次のいずれかのプロモート操作を行います。
      • すべてのデータベースをプロモートする場合は、ツールバーの [プロモート] をクリックします。
      • 特定のデータベースのみをプロモートする場合は、[データベース] タブでデータベースを選択し、[プロモート] をクリックします。
    4. ダイアログにエラーが表示されていないことを確認し、[プロモート] をクリックします。

    移行先インスタンスから:

    1. Google Cloud コンソールで、Cloud SQL の [インスタンス] ページに移動します。

      Cloud SQL の [インスタンス] に移動

    2. 移行先のインスタンスの表示名をクリックします。

      インスタンスの詳細ページが開きます。

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

    gcloud

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

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

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

    • 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

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