查看及管理遷移工作

在 Google Cloud 控制台中，您可以對 狀態相同的遷移作業執行批次動作。您可以在 Google Cloud 控制台和使用 Google Cloud CLI，對單一遷移作業執行動作。

您可以對遷移作業執行下列任一動作：

動作	說明
開始	啟動不處於「執行中」或「啟動中」狀態的遷移工作。請參閱 遷移工作狀態。
停止	停止執行中的遷移工作。資料移動作業已暫停。 遷移工作狀態會先變更為 Stopping， 然後變更為 Stopped。您可以繼續、刪除或 升級已停止的遷移工作。 在某些情況下，來源資料庫必須保留資料，直到您繼續執行遷移工作為止。來源資料庫的保留期限可能有限。如果遷移工作暫停時間超過保留期限，然後又繼續執行，可能會導致遷移工作失敗。如果發生這種情況，請刪除或重新啟動遷移工作。
繼續	您可以繼續執行在 CDC 階段停止的遷移工作。 繼續執行遷移工作時，資料庫遷移服務會繼續複製遷移工作停止期間累積的變更事件。
重新啟動	如果遷移工作發生錯誤，無法繼續複製資料，您可以重新啟動該工作。重新啟動遷移工作後會發生什麼情況，取決於工作失敗的原因： 如果一或多個來源或目的地資料庫資料表發生錯誤，導致複寫失敗，重新啟動遷移工作會清除遷移工作所含目的地資料庫資料表的所有資料。 重新啟動遷移工作不會導致資料庫移轉服務複製您在來源資料庫中建立的新資料表。您必須先 將資料表新增至轉換工作區並轉換結構定義。
編輯	請參閱「 編輯遷移工作」。
刪除	您可以刪除遷移工作。結果取決於工作狀態： 如果遷移工作處於 Completed 狀態，系統會從遷移工作清單中刪除記錄。 如果遷移工作處於其他狀態，您可以選擇刪除相關聯的目的地 Cloud SQL 執行個體。
宣傳	在遷移過程中，目的地資料庫會進入唯讀狀態，並由資料庫遷移服務全面管理。如要將應用程式切換至遷移後的目的地資料庫，請推送遷移工作，將目的地資料庫更新為獨立副本。請參閱「 推送遷移作業」。

審查遷移工作

1. 前往 Google Cloud 控制台的「遷移作業」頁面。

   前往「遷移工作」

2. 選取遷移工作即可查看詳細資料頁面，包括：
   • 遷移工作的中繼資料，例如顯示名稱、ID、遷移類型、來源連線設定檔、來源資料庫引擎、目的地、連線方法、遷移工作的建立日期和時間，以及遷移工作的執行時間。
   • 遷移工作狀態和子狀態，以及其他資訊。視遷移作業的狀態和子狀態而定，可用的動作會有所不同。

啟動遷移工作

完整建立遷移工作後 (也就是未儲存為草稿)，您隨時可以啟動工作，開始遷移資料。

如要啟動遷移作業，請按照下列步驟操作：

控制台

1. 前往 Google Cloud 控制台的「遷移作業」頁面。

   前往「遷移工作」

2. 在「Jobs」分頁中，按一下要啟動的遷移工作顯示名稱。

   系統會開啟遷移工作詳細資料頁面。

3. 按一下「啟動」。
4. 在對話方塊中，按一下「開始」。

gcloud

使用下方的任何指令資料之前，請先替換以下項目：

• MIGRATION_JOB_ID，並提供遷移工作 ID。

  如果您不知道 ID，可以使用 gcloud database-migration migration-jobs list 指令列出特定區域中的所有遷移工作，並查看其 ID。

• REGION，其中包含儲存連線設定檔的區域 ID。

執行下列指令：

Linux、macOS 或 Cloud Shell

注意： 請確認您已透過執行下列任一指令，初始化 Google Cloud CLI 的驗證和專案： gcloud init； 或 gcloud auth login 和 gcloud config set project。

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

Windows (PowerShell)

注意： 請確認您已透過執行下列任一指令，初始化 Google Cloud CLI 的驗證和專案： gcloud init； 或 gcloud auth login 和 gcloud config set project。

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

Windows (cmd.exe)

注意： 請確認您已透過執行下列任一指令，初始化 Google Cloud CLI 的驗證和專案： gcloud init； 或 gcloud auth login 和 gcloud config set project。

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 describe 指令查看遷移工作狀態。
• 使用 gcloud database-migration operations describe 搭配 OPERATION_ID，即可查看作業本身的狀態。

停止遷移工作

您隨時可以停止正在執行的遷移作業，步驟如下：

控制台

1. 前往 Google Cloud 控制台的「遷移作業」頁面。

   前往「遷移工作」

2. 在「Jobs」分頁中，按一下要啟動的遷移工作顯示名稱。

   系統會開啟遷移工作詳細資料頁面。

3. 按一下「停止」。
4. 在對話方塊中，按一下「停止」。

gcloud

使用下方的任何指令資料之前，請先替換以下項目：

• MIGRATION_JOB_ID，並提供遷移工作 ID。

  如果您不知道 ID，可以使用 gcloud database-migration migration-jobs list 指令列出特定區域中的所有遷移工作，並查看其 ID。

• REGION，其中包含儲存連線設定檔的區域 ID。

執行下列指令：

Linux、macOS 或 Cloud Shell

注意： 請確認您已透過執行下列任一指令，初始化 Google Cloud CLI 的驗證和專案： gcloud init； 或 gcloud auth login 和 gcloud config set project。

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

Windows (PowerShell)

注意： 請確認您已透過執行下列任一指令，初始化 Google Cloud CLI 的驗證和專案： gcloud init； 或 gcloud auth login 和 gcloud config set project。

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

Windows (cmd.exe)

注意： 請確認您已透過執行下列任一指令，初始化 Google Cloud CLI 的驗證和專案： gcloud init； 或 gcloud auth login 和 gcloud config set project。

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 describe 指令查看遷移工作狀態。
• 使用 gcloud database-migration operations describe 搭配 OPERATION_ID，即可查看作業本身的狀態。

繼續執行遷移工作

如要繼續 停止的遷移工作，請按照下列步驟操作：

控制台

1. 前往 Google Cloud 控制台的「遷移作業」頁面。

   前往「遷移工作」

2. 在「Jobs」分頁中，按一下要啟動的遷移工作顯示名稱。

   系統會開啟遷移工作詳細資料頁面。

3. 按一下「繼續」。
4. 在對話方塊中，按一下「繼續」。

gcloud

使用下方的任何指令資料之前，請先替換以下項目：

• MIGRATION_JOB_ID，並提供遷移工作 ID。

  如果您不知道 ID，可以使用 gcloud database-migration migration-jobs list 指令列出特定區域中的所有遷移工作，並查看其 ID。

• REGION，其中包含儲存連線設定檔的區域 ID。

執行下列指令：

Linux、macOS 或 Cloud Shell

注意： 請確認您已透過執行下列任一指令，初始化 Google Cloud CLI 的驗證和專案： gcloud init； 或 gcloud auth login 和 gcloud config set project。

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

Windows (PowerShell)

注意： 請確認您已透過執行下列任一指令，初始化 Google Cloud CLI 的驗證和專案： gcloud init； 或 gcloud auth login 和 gcloud config set project。

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

Windows (cmd.exe)

注意： 請確認您已透過執行下列任一指令，初始化 Google Cloud CLI 的驗證和專案： gcloud init； 或 gcloud auth login 和 gcloud config set project。

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 describe 指令查看遷移工作狀態。
• 使用 gcloud database-migration operations describe 搭配 OPERATION_ID，即可查看作業本身的狀態。

重新啟動遷移工作

如要啟動遷移作業，請按照下列步驟操作：

控制台

1. 前往 Google Cloud 控制台的「遷移作業」頁面。

   前往「遷移工作」

2. 在「Jobs」分頁中，按一下要重新啟動的遷移工作顯示名稱。

   系統會開啟遷移工作詳細資料頁面。

3. 按一下 [Restart]。
4. 在對話方塊中，按一下「重新啟動」。

gcloud

使用下方的任何指令資料之前，請先替換以下項目：

• MIGRATION_JOB_ID，並提供遷移工作 ID。

  如果您不知道 ID，可以使用 gcloud database-migration migration-jobs list 指令列出特定區域中的所有遷移工作，並查看其 ID。

• REGION，其中包含儲存連線設定檔的區域 ID。

• 選用：根據預設，資料庫移轉服務會遷移來源中的所有資料庫。如要只遷移特定資料庫，請使用 --databases-filter 旗標，並以半形逗號分隔清單的形式指定資料庫 ID。

  例如：--databases-filter=my-business-database,my-other-database

  日後您可以使用 gcloud database-migration migration-jobs update 指令，編輯使用 --database-filter flag 建立的遷移作業。

執行下列指令：

Linux、macOS 或 Cloud Shell

注意： 請確認您已透過執行下列任一指令，初始化 Google Cloud CLI 的驗證和專案： gcloud init； 或 gcloud auth login 和 gcloud config set project。

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

Windows (PowerShell)

注意： 請確認您已透過執行下列任一指令，初始化 Google Cloud CLI 的驗證和專案： gcloud init； 或 gcloud auth login 和 gcloud config set project。

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

Windows (cmd.exe)

注意： 請確認您已透過執行下列任一指令，初始化 Google Cloud CLI 的驗證和專案： gcloud init； 或 gcloud auth login 和 gcloud config set project。

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

如要查看作業是否成功，可以查詢傳回的作業物件， 或檢查遷移作業的狀態：

• 使用 gcloud database-migration migration-jobs describe 指令查看遷移工作狀態。
• 使用 gcloud database-migration operations describe 搭配 OPERATION_ID，即可查看作業本身的狀態。

更新遷移工作草稿

如要完成建立遷移作業，請執行下列步驟：

1. 前往 Google Cloud 控制台的「遷移作業」頁面。

   前往「遷移工作」

2. 在「草稿」分頁中，按一下要完成建立的遷移作業顯示名稱。

   系統會開啟遷移工作建立精靈。

3. 完成建立遷移工作。請參閱 建立遷移工作。

編輯遷移工作

您可以修改來源的設定資訊，例如資料庫移轉服務要從來源遷移至目的地的資料庫資料表和結構定義。資料庫移轉服務會使用這項設定資訊，將正確的資料從來源遷移至目的地。

在遷移作業中新增或移除物件

如要新增或移除遷移作業中的表格或結構定義，請按照下列步驟操作：

1. 前往 Google Cloud 控制台的「遷移工作」頁面。

   前往「遷移工作」

2. 按一下要修改的遷移作業顯示名稱。系統隨即會顯示遷移工作的總覽頁面。

3. 在「選取要遷移的物件」部分，選取或取消勾選核取方塊，變更資料庫遷移服務要從來源遷移至目的地的資料表和結構定義。

   確認目的地有您選取的任何結構定義。

4. 按一下「儲存」或「儲存並重新啟動」。

   • 如果您點按「儲存」，資料庫移轉服務只會遷移您所選架構和資料表的歷史資料。

   • 如果您按一下「儲存並重新啟動」，資料庫移轉服務就會在清除您在目的地中選取的任何資料表後，從頭開始遷移。

調整來源資料庫的並行連線數上限

您可以自訂資料庫移轉服務可與來源執行個體建立的並行連線數量上限，以用於完整傾印階段或 CDC 階段。

1. 前往 Google Cloud 控制台的「遷移作業」頁面。

   前往「遷移工作」

2. 按一下要修改的遷移作業顯示名稱。 系統隨即會顯示遷移工作的總覽頁面。

3. 展開「Customize source configuration」(自訂來源設定) >「Source read settings」(來源讀取設定) 區段。

4. 在「完整 dump 並行連線數量上限」或「CDC 並行連線數量上限」 部分，使用「自訂」欄位，輸入完整 dump 或 CDC 階段的連線數量上限。

5. 按一下「儲存」或「儲存並重新啟動」。

調整目的地設定

您可以自訂目的地資料庫的交易逾時時間和並行連線數量上限：

1. 前往 Google Cloud 控制台的「遷移工作」頁面。

   前往「遷移工作」頁面

2. 按一下要修改的遷移作業顯示名稱。

   系統隨即會顯示遷移工作的總覽頁面。

3. 展開「自訂目的地設定」部分，然後修改下列設定：

   目的地並行連線數量上限

   預設值：128

   允許的值：最小值 2、最大值 256

   您可以自訂資料庫移轉服務可連線至目的地執行個體的並行連線數量上限。

   資料庫遷移服務會調整連線數，確保在提供的連線限制內發揮最佳效能。提高連線數量上限可加快遷移速度，但會增加目標資料庫的負載。

   交易逾時

   預設值：30

   允許的值：最小值 30、最大值 300

   在遷移過程中，資料庫遷移服務可能會遇到某些問題，導致交易逾時。您可以調整資料庫遷移服務等待交易完成的時間 (以秒為單位)，超過這個時間就會取消交易。

   取消交易不會導致遷移工作失敗。 遷移工作會繼續複製資料，但會移至「執行中但發生錯誤」狀態。您可以查看遷移工作詳細資料，瞭解需要解決哪些問題。

4. 按一下「儲存」或「儲存並重新啟動」。

測試遷移工作

執行遷移工作前，您可以先執行測試作業，確認資料庫遷移服務是否能存取所有必要的來源和目的地實體。在 Google Cloud 控制台中，您只能測試在遷移工作建立精靈中建立的草稿遷移工作 (請參閱「建立遷移工作」)。

使用 gcloud CLI，您可以測試已建立但尚未啟動的遷移作業。

使用下方的任何指令資料之前，請先替換以下項目：

• MIGRATION_JOB_ID，並提供遷移工作 ID。

  如果您不知道 ID，可以使用 gcloud database-migration migration-jobs list 指令列出特定區域中的所有遷移工作，並查看其 ID。

• REGION，其中包含儲存連線設定檔的區域 ID。

執行下列指令：

Linux、macOS 或 Cloud Shell

注意： 請確認您已透過執行下列任一指令，初始化 Google Cloud CLI 的驗證和專案： gcloud init； 或 gcloud auth login 和 gcloud config set project。

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

Windows (PowerShell)

注意： 請確認您已透過執行下列任一指令，初始化 Google Cloud CLI 的驗證和專案： gcloud init； 或 gcloud auth login 和 gcloud config set project。

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

Windows (cmd.exe)

注意： 請確認您已透過執行下列任一指令，初始化 Google Cloud CLI 的驗證和專案： gcloud init； 或 gcloud auth login 和 gcloud config set project。

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 指令查看遷移工作狀態。
• 使用 gcloud database-migration operations describe 搭配 OPERATION_ID，即可查看作業本身的狀態。