移行ジョブの表示と管理

Google Cloud コンソールでは、同じ ステータスの移行ジョブに対して一括でアクションを実行できます。単一の移行ジョブに対して、 Google Cloud コンソールと Google Cloud CLI の両方でアクションを実行できます。

移行ジョブに対して次のいずれかの操作を行うことができます。

移行ジョブの確認

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

   移行ジョブに移動する

2. 移行ジョブを選択して、詳細ページを表示します。このページには次の情報が表示されます。
   • 移行ジョブのメタデータ（表示名、ID、移行タイプ、移行元接続プロファイル、移行元データベース エンジン、移行先、接続方法、移行ジョブの作成日時、移行ジョブの実行時間など）。
   • 移行ジョブのステータスとサブステータス、追加情報。移行ジョブのステータスとサブステータスに応じて、さまざまなアクションを使用できます。

移行ジョブを開始する

移行ジョブが完全に作成されると（下書き状態ではない場合）、いつでも開始してデータの移行を開始できます。

移行ジョブを開始するには、次の操作を行います。

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

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

gcloud database-migration migration-jobs ^
start 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 \
stop MIGRATION_JOB_ID \
  --region=REGION

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

gcloud database-migration migration-jobs ^
stop 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: stop
name: OPERATION_ID

移行ジョブを再開する

停止した移行ジョブを再開するには、次の操作を行います。

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

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

gcloud database-migration migration-jobs ^
resume 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: resume
name: OPERATION_ID

移行ジョブを再開する

移行ジョブを開始するには、次の操作を行います。

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

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

gcloud database-migration migration-jobs ^
restart 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: restart
name: OPERATION_ID

移行ジョブの下書きを更新する

移行ジョブの作成を完了するには、次の操作を行います。

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

   移行ジョブに移動する

2. [下書き] タブで、作成を完了する移行ジョブの表示名をクリックします。

   移行ジョブ作成ウィザードが開きます。

3. 移行ジョブの作成を完了します。 移行ジョブを作成するをご覧ください。

移行ジョブを編集する

移行元データベースのテーブルやスキーマなど、Database Migration Service が移行先に移行する移行元の構成情報を変更できます。Database Migration Service は、この構成情報を使用して、移行元から移行先に正しいデータを移行します。

移行からオブジェクトを追加または削除する

移行からテーブルまたはスキーマを追加または削除する手順は次のとおりです。

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

   移行ジョブに移動する

2. 変更する移行ジョブの表示名をクリックします。移行ジョブの概要ページが表示されます。

3. [移行するオブジェクトを選択] セクションで、チェックボックスをオンまたはオフにして、Database Migration Service が移行先に移行する移行元のテーブルとスキーマを変更します。

4. [保存] または [保存して再起動] をクリックします。

   • [保存] をクリックすると、Database Migration Service は、選択したスキーマとテーブルの履歴データのみを移動します。

   • [保存して再開] をクリックすると、移行先で選択したテーブルをクリーンアップした後、Database Migration Service が最初から移行を開始します。

ソース データベースへの同時接続の最大数を調整する

完全なダンプフェーズまたは CDC フェーズで、Database Migration Service が移行元インスタンスに作成できる最大同時接続数をカスタマイズできます。

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

   移行ジョブに移動する

2. 変更する移行ジョブの表示名をクリックします。移行ジョブの概要ページが表示されます。

3. [ソース構成をカスタマイズ] > [ソース読み取り設定] セクションを開きます。

4. [最大同時フルダンプ接続数] セクションまたは [最大同時 CDC 接続数] セクションで、[カスタム] フィールドを使用して、フルダンプ フェーズまたは CDC フェーズの最大接続数の上限を入力します。

5. [保存] または [保存して再起動] をクリックします。

移行先の構成設定を調整する

移行先データベースのトランザクション タイムアウトと最大同時接続数をカスタマイズできます。

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

   [移行ジョブ] に移動します。

2. 変更する移行ジョブの表示名をクリックします。

   移行ジョブの概要ページが表示されます。

3. [送信先構成をカスタマイズ] セクションを開き、次の設定を変更します。

   移行先の最大同時接続数

   デフォルト値: 128

   許容値: 最小値 2、最大値 256

   Database Migration Service が移行先インスタンスに確立できる最大同時接続数をカスタマイズできます。

   Database Migration Service は、指定された接続制限内で最適なパフォーマンスを確保するために、接続数を調整します。最大接続数を増やすと移行速度を向上させることができますが、移行先のデータベースに負荷がかかります。

   トランザクションのタイムアウト

   デフォルト値: 30

   許容値: 最小値 30、最大値 300

   移行プロセス中に、Database Migration Service でトランザクションがタイムアウトする原因となる特定の問題が発生することがあります。Database Migration Service がトランザクションの完了を待機してからキャンセルするまでの秒数を調整できます。

   トランザクションがキャンセルされても、移行ジョブは失敗しません。移行ジョブはデータのコピーを続行しますが、ステータスが [Running with errors] に変わります。移行ジョブの詳細を表示して、対処が必要な問題を確認できます。

4. [保存] または [保存して再起動] をクリックします。

移行ジョブをテストする

移行ジョブを実行する前に、テスト オペレーションを実行して、Database Migration Service が必要な移行元エンティティと移行先エンティティにすべてアクセスできるかどうかを確認できます。 Google Cloud コンソールでは、移行ジョブ作成ウィザードで作成した移行ジョブの下書きのみをテストできます（ 移行ジョブを作成するをご覧ください）。

gcloud CLI を使用すると、作成済みでまだ開始されていない移行ジョブをテストできます。

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

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

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

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

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

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

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

gcloud database-migration migration-jobs ^
verify 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: verify
name: OPERATION_ID

• gcloud database-migration migration-jobs describe コマンドを使用して、移行ジョブのステータスを表示します。
• OPERATION_ID とともに gcloud database-migration operations describe を使用して、オペレーション自体のステータスを確認します。