移行ジョブの管理

Google Cloud コンソールでは、同じ ステータスの移行ジョブに対して一括でアクションを実行できます。1 つの移行ジョブに対して、 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 によってフルマネージドされるリカバリモード(Recovery mode)になります。移行ジョブまたは選択したデータベースをプロモートするまで、移行先データベースで読み取りオペレーションや書き込みオペレーションを実行することはできません。詳細については、 移行をプロモートするをご覧ください。
表示 移行ジョブで特定のデータベースの詳細を表示するか、移行対象として選択したすべてのデータベースの詳細を表示できます。

移行ジョブを開始する

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

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

コンソール

移行ジョブは、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 は、移行ジョブが保存されているリージョンの 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

結果

このアクションは非同期で実行されます。そのため、このコマンドは、長時間実行オペレーションを表す 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

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

移行ジョブを停止する

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

コンソール

移行ジョブは、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 は、接続プロファイルが保存されているリージョンの識別子に置き換えます。

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

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

結果

このアクションは非同期で実行されます。そのため、このコマンドは、長時間実行オペレーションを表す 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: 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 に置き換えます。

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

  • 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

結果

このアクションは非同期で実行されます。そのため、このコマンドは、長時間実行オペレーションを表す 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: 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 に置き換えます。

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

  • 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

結果

このアクションは非同期で実行されます。そのため、このコマンドは、長時間実行オペレーションを表す 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: 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 のデータベース ID のカンマ区切りのリストに置き換えます。

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

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 に置き換えます。

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

  • REGION は、接続プロファイルが保存されているリージョンの識別子に置き換えます。
  • COMMA_SEPARATED_DATABASE_ID_LIST は、バックアップ ファイルから移行する SQL Server のデータベース ID のカンマ区切りリストに置き換えます。これらの識別子は、 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 に置き換えます。

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

  • 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 に置き換えます。

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

  • 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

結果

このアクションは非同期で実行されます。そのため、このコマンドは、長時間実行オペレーションを表す 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: verify
name: OPERATION_ID
オペレーションが成功したかどうかを確認するには、返されたオペレーション オブジェクトをクエリするか、移行ジョブのステータスを確認します。

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

移行ジョブが完全に作成されると(つまり、ドラフト状態で保存されていない場合)、Google Cloud CLI を使用して、その移行ジョブ内の特定のデータベースの詳細を表示できます。

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

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

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

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

  • 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 に置き換えます。

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

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