移行ジョブの管理

Google Cloud コンソールでは、同じ ステータスの移行ジョブに対して一括でアクションを実行できます。単一の移行ジョブに対するアクションは、 Google Cloud コンソール(Database Migration Service コンソールまたは宛先 Cloud SQL インスタンス ページから直接)と Google Cloud CLI の両方で実行できます。

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

アクション 説明
編集

下書き以外の移行ジョブを編集して、次の変更を行うことができます。

開始 実行中または開始中の状態ではない移行ジョブを開始します。 移行ジョブのステータスをご覧ください。
停止 実行中の移行ジョブを停止します。データ移動が一時停止されます。移行ジョブのステータスは、最初に Stopping に変わり、次に Stopped に変わります。停止した移行ジョブは、再開、削除、または 昇格できます。
再開 増分読み込み中に移行ジョブを停止した場合は、後で再開できます。移行ジョブを再開すると、Database Migration Service は移行ジョブの停止中に蓄積されたすべてのトランザクション ログファイルを取得します。
再起動

エラーが発生し、データ レプリケーションを続行できない移行ジョブを再開できます。

移行ジョブの再開の結果は、失敗した理由によって異なります。

  • エラーから復元できない移行ジョブが失敗すると、完全バックアップ ファイルの初期読み込みを含め、移行プロセス全体が再試行されます。
  • 1 つ以上の移行元データベースまたは移行先データベースのエラーが原因でレプリケーションが失敗した場合、移行を再開すると、移行先データベースからすべてのデータが消去されます。
  • 移行の開始後に別のデータベースの新しいフォルダを作成し、 移行用に選択したデータベースに追加すると、移行を再開したときに、新しいデータベースも移行先インスタンスに複製されます。
削除 移行ジョブは削除できます。結果はジョブのステータスによって異なります。
  • 移行ジョブが Completed ステータスの場合は、移行ジョブリストからレコードが削除されます。
  • 移行ジョブが他のステータスの場合、移行先の Cloud SQL インスタンス/プライマリ ペアを削除するオプションを選択できます。
プロモート 移行プロセス中、移行先の Cloud SQL for SQL Server データベースは復元モードになり、Database Migration Service によって完全に管理されます。移行ジョブまたは選択したデータベースをプロモートするまで、移行先データベースに対して読み取り / 書き込みオペレーションを実行することはできません。詳細については、 移行をプロモートするをご覧ください。
表示 移行ジョブの特定のデータベースの詳細、または移行用に選択したすべてのデータベースの詳細を表示できます。

移行ジョブを開始する

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

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

コンソール

移行ジョブは、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 に置き換えます。

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

  • REGION: 移行ジョブが保存されているリージョンの ID。

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

Linux、macOS、Cloud Shell

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

Windows(PowerShell)

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

Windows(cmd.exe)

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

オペレーションが成功したかどうかを確認するには、返されたオペレーション オブジェクトをクエリするか、移行ジョブのステータスを確認します。

移行ジョブを停止する

次の手順を行うと、 実行中の移行ジョブをいつでも停止できます。

コンソール

移行ジョブは、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 に置き換えます。

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

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

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

Linux、macOS、Cloud Shell

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

Windows(PowerShell)

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

Windows(cmd.exe)

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
オペレーションが成功したかどうかを確認するには、返されたオペレーション オブジェクトをクエリするか、移行ジョブのステータスを確認します。

移行ジョブを再開する

停止した移行ジョブを再開する手順は次のとおりです。

コンソール

移行ジョブは、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 に置き換えます。

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

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

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

Linux、macOS、Cloud Shell

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

Windows(PowerShell)

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

Windows(cmd.exe)

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
オペレーションが成功したかどうかを確認するには、返されたオペレーション オブジェクトをクエリするか、移行ジョブのステータスを確認します。

移行ジョブを再開する

移行ジョブを再開する手順は次のとおりです。

コンソール

移行ジョブは、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 に置き換えます。

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

  • REGION: 移行ジョブが保存されているリージョンの ID。
  • 省略可: 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 \
restart MIGRATION_JOB_ID \
  --region=REGION

Windows(PowerShell)

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

Windows(cmd.exe)

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. 移行ジョブの作成を完了します。 移行ジョブを作成するをご覧ください。

gcloud

このサンプルでは、すべてのオペレーションが同期的に実行されるように、オプションの --no-async フラグを使用しています。そのため、一部のコマンドの完了に時間がかかることがあります。--no-async フラグを省略して、コマンドを非同期で実行できます。その場合は、 gcloud database-migration operations describe コマンドを使用して、オペレーションが成功したかどうかを確認する必要があります。

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

  • MIGRATION_JOB_ID: 移行ジョブのマシン可読識別子。
  • REGION は、接続プロファイルを保存するリージョン ID に置き換えます。
  • MIGRATION_JOB_NAME は、移行ジョブの人間が読める名前に置き換えます。この値は、 Google Cloud コンソールの Database Migration Service に表示されます。
  • SOURCE_CONNECTION_PROFILE_ID: ソース接続プロファイルの機械可読形式の識別子。
  • DESTINATION_CONNECTION_PROFILE_ID: 移行先接続プロファイルの機械可読識別子。
  • 差分バックアップ構成: 移行ジョブで Cloud Storage バケットの差分バックアップ ファイルを使用できるかどうかを構成できます。コマンドに次のいずれかのフラグを追加します。
    • --sqlserver-diff-backup: 移行用の差分バックアップ ファイルを有効にします
    • --no-sqlserver-diff-backup: 移行の差分バックアップ ファイルを無効にします。

    サポートされているバックアップ ファイルの詳細については、 サポートされているバックアップ ファイル形式をご覧ください。

  • COMMA_SEPARATED_DATABASE_ID_LIST。バックアップ ファイルから移行する SQL Server のデータベース識別子のカンマ区切りのリスト。

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

Linux、macOS、Cloud Shell

gcloud database-migration migration-jobs \
create MIGRATION_JOB_ID \
  --no-async \
  --region=REGION \
  --display-name=MIGRATION_JOB_NAME \
  --source=SOURCE_CONNECTION_PROFILE_ID \
  --destination=DESTINATION_CONNECTION_PROFILE_ID \
  --sqlserver-databases=COMMA_SEPARATED_DATABASE_ID_LIST \
  --type=CONTINUOUS

Windows(PowerShell)

gcloud database-migration migration-jobs `
create MIGRATION_JOB_ID `
  --no-async `
  --region=REGION `
  --display-name=MIGRATION_JOB_NAME `
  --source=SOURCE_CONNECTION_PROFILE_ID `
  --destination=DESTINATION_CONNECTION_PROFILE_ID `
  --sqlserver-databases=COMMA_SEPARATED_DATABASE_ID_LIST `
  --type=CONTINUOUS

Windows(cmd.exe)

gcloud database-migration migration-jobs ^
create MIGRATION_JOB_ID ^
  --no-async ^
  --region=REGION ^
  --display-name=MIGRATION_JOB_NAME ^
  --source=SOURCE_CONNECTION_PROFILE_ID ^
  --destination=DESTINATION_CONNECTION_PROFILE_ID ^
  --sqlserver-databases=COMMA_SEPARATED_DATABASE_ID_LIST ^
  --type=CONTINUOUS

次のようなレスポンスが返されます。

Waiting for migration job [MIGRATION_JOB_ID]
to be updated with [OPERATION_ID]

Waiting for operation [OPERATION_ID] to complete...done.

Updated migration job MIGRATION_JOB_ID [OPERATION_ID]

移行ジョブにデータベースを追加または削除する

移行ジョブに新しいデータベースを追加するには、まず Cloud Storage バケットに新しい専用フォルダを作成し、そこにバックアップ ファイルをアップロードする必要があります。 Cloud Storage バケットを構成するをご覧ください。

必要なバックアップ ファイルが Cloud Storage バケットにある場合は、次の手順を行います。

コンソール

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

    移行ジョブに移動する

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

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

  3. [編集] をクリックします。
  4. [移行するデータベースを選択] セクションで、チェックボックスを使用して、移行ジョブに追加する新しいデータベースを選択するか、削除するデータベースのチェックを外します。
  5. (省略可)暗号化されたバックアップを使用する場合は、バックアップの暗号鍵を指定します。暗号化されたバックアップの使用について詳しくは、 暗号化されたバックアップを使用するをご覧ください。

    次の操作を行います。

    • 移行用に選択したデータベースの横にある [詳細を編集] をクリックします。

      [暗号化] サイドパネルが開きます。

    • [暗号鍵] メニューを使用して鍵を選択します。
    • [Password] 欄に暗号鍵のパスワードを入力します。
    • [Save and exit] をクリックします。

gcloud

このサンプルでは、すべてのオペレーションが同期的に実行されるように、オプションの --no-async フラグを使用しています。そのため、一部のコマンドの完了に時間がかかることがあります。--no-async フラグを省略して、コマンドを非同期で実行できます。その場合は、 gcloud database-migration operations describe コマンドを使用して、オペレーションが成功したかどうかを確認する必要があります。

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

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

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

  • REGION は、接続プロファイルが保存されているリージョンの識別子に置き換えます。
  • COMMA_SEPARATED_DATABASE_ID_LIST。バックアップ ファイルから移行する SQL Server のデータベース識別子のカンマ区切りのリスト。これらの識別子は、 Cloud Storage のデータベース フォルダ名と同じである必要があります。

    例: --sqlserver-databases=my-business-database,my-other-database

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

Linux、macOS、Cloud Shell

gcloud database-migration migration-jobs \
update MIGRATION_JOB_ID \
  --region=REGION \
  --sqlserver-databases=COMMA_SEPARATED_DATABASE_ID_LIST

Windows(PowerShell)

gcloud database-migration migration-jobs `
update MIGRATION_JOB_ID `
  --region=REGION `
  --sqlserver-databases=COMMA_SEPARATED_DATABASE_ID_LIST

Windows(cmd.exe)

gcloud database-migration migration-jobs ^
update MIGRATION_JOB_ID ^
  --region=REGION ^
  --sqlserver-databases=COMMA_SEPARATED_DATABASE_ID_LIST

次のようなレスポンスが返されます。

Waiting for migration job [MIGRATION_JOB_ID]
to be updated with [OPERATION_ID]

Waiting for operation [OPERATION_ID] to complete...done.

Updated migration job MIGRATION_JOB_ID [OPERATION_ID]

下書き以外の移行ジョブを編集する

下書き以外の移行ジョブの場合は、Google Cloud CLI を使用して移行ジョブの表示名を変更できます。

このサンプルでは、すべてのオペレーションが同期的に実行されるように、オプションの --no-async フラグを使用しています。そのため、一部のコマンドの完了に時間がかかることがあります。--no-async フラグを省略して、コマンドを非同期で実行できます。その場合は、 gcloud database-migration operations describe コマンドを使用して、オペレーションが成功したかどうかを確認する必要があります。

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

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

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

  • REGION は、接続プロファイルが保存されているリージョンの識別子に置き換えます。
  • MIGRATION_JOB_NAME は、移行ジョブの人間が読める名前に置き換えます。この値は、 Google Cloud コンソールの Database Migration Service に表示されます。

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

Linux、macOS、Cloud Shell

gcloud database-migration migration-jobs \
update MIGRATION_JOB_ID \
  --region=REGION \
  --display-name=MIGRATION_JOB_NAME

Windows(PowerShell)

gcloud database-migration migration-jobs `
update MIGRATION_JOB_ID `
  --region=REGION `
  --display-name=MIGRATION_JOB_NAME

Windows(cmd.exe)

gcloud database-migration migration-jobs ^
update MIGRATION_JOB_ID ^
  --region=REGION ^
  --display-name=MIGRATION_JOB_NAME

次のようなレスポンスが返されます。

Waiting for migration job [MIGRATION_JOB_ID]
to be updated with [OPERATION_ID]

Waiting for operation [OPERATION_ID] to complete...done.

Updated migration job MIGRATION_JOB_ID [OPERATION_ID]

移行ジョブをテストする

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

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

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

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

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

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

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

Linux、macOS、Cloud Shell

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

Windows(PowerShell)

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

Windows(cmd.exe)

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
オペレーションが成功したかどうかを確認するには、返されたオペレーション オブジェクトをクエリするか、移行ジョブのステータスを確認します。

特定のデータベースの移行の詳細を表示する

移行ジョブが完全に作成されたら(下書き状態ではない場合)、Google Cloud CLI を使用して、その移行ジョブ内の特定のデータベースの詳細を表示できます。

このサンプルでは、すべてのオペレーションが同期的に実行されるように、オプションの --no-async フラグを使用しています。そのため、一部のコマンドの完了に時間がかかることがあります。--no-async フラグを省略して、コマンドを非同期で実行できます。その場合は、 gcloud database-migration operations describe コマンドを使用して、オペレーションが成功したかどうかを確認する必要があります。

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

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

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

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

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

Linux、macOS、Cloud Shell

gcloud database-migration objects lookup --migration-job=MIGRATION_JOB_ID \
  --region=REGION --database=DATABASE_NAME

Windows(PowerShell)

gcloud database-migration objects lookup --migration-job=MIGRATION_JOB_ID `
  --region=REGION --database=DATABASE_NAME

Windows(cmd.exe)

gcloud database-migration objects lookup --migration-job=MIGRATION_JOB_ID ^
  --region=REGION --database=DATABASE_NAME

結果

出力は次のようになります。

createTime: '2025-03-21T17:05:19.211441641Z'
name: PROJECT_ID
phase: FULL_DUMP
sourceObject:
  database: DATABASE_NAME
  type: DATABASE
state: RUNNING
オペレーションが成功したかどうかを確認するには、返されたオペレーション オブジェクトをクエリするか、移行ジョブのステータスを確認します。

特定のデータベースの移行の詳細を表示する

移行ジョブが完全に作成されたら(下書き状態ではない場合)、Google Cloud CLI を使用して、その移行ジョブで選択したすべてのデータベースを一覧表示し、詳細を表示できます。

このサンプルでは、すべてのオペレーションが同期的に実行されるように、オプションの --no-async フラグを使用しています。そのため、一部のコマンドの完了に時間がかかることがあります。--no-async フラグを省略して、コマンドを非同期で実行できます。その場合は、 gcloud database-migration operations describe コマンドを使用して、オペレーションが成功したかどうかを確認する必要があります。

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

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

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

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

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

Linux、macOS、Cloud Shell

gcloud database-migration objects list --migration-job=MIGRATION_JOB_ID \
  --region=REGION

Windows(PowerShell)

gcloud database-migration objects list --migration-job=MIGRATION_JOB_ID `
  --region=REGION

Windows(cmd.exe)

gcloud database-migration objects list --migration-job=MIGRATION_JOB_ID ^
  --region=REGION

結果

出力は次のようになります。

Waiting for migration job MIGRATION_JOB_ID
to fetch source objects with OPERATION_ID

Waiting for operation OPERATION_ID to complete...done.

SOURCE_OBJECT                            STATE    PHASE      ERROR
{'database': 'db1', 'type': 'DATABASE'}  RUNNING  FULL_DUMP
{'database': 'db2', 'type': 'DATABASE'}  STOPPED  CDC        {'code': 1, 'message': 'Internal error'}
オペレーションが成功したかどうかを確認するには、返されたオペレーション オブジェクトをクエリするか、移行ジョブのステータスを確認します。