移行の最終処理を行う

継続的移行では、読み取りと書き込みを移行先データベースに移動するタイミングになったら、昇格プロセスを開始できます。プロモートとは、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 は、接続プロファイルが保存されているリージョンの識別子に置き換えます。
    • 省略可: 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

    結果

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

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