建立轉換工作區並轉換結構定義

本頁面說明如何建立轉換工作區，並立即使用該工作區，以確定性方式將 Oracle 的程式碼和結構定義轉換為 PostgreSQL。建立工作區前，請務必 為來源資料庫建立連線設定檔。

必要的角色

如要取得建立轉換工作區所需的權限，請要求管理員授予您專案的「 Database Migration Admin」(roles/datamigration.admin) IAM 角色。

如要進一步瞭解如何授予角色，請參閱 Identity and Access Management 說明文件中的「 管理存取權」。

這個預先定義的角色具備在資料庫遷移服務中建立轉換工作區所需的權限。如要查看確切的必要權限，請展開「Required permissions」(必要權限) 部分：

所需權限

如要在資料庫遷移服務中建立轉換工作區，您必須具備下列權限：

  • cloudaicompanion.entitlements.get

    roles/datamigration.admin 角色包含此權限。如要使用 Gemini 強化轉換功能，就必須這麼做。

  • datamigration.conversionworkspaces.apply
  • datamigration.conversionworkspaces.commit
  • datamigration.conversionworkspaces.convert
  • datamigration.conversionworkspaces.create
  • datamigration.conversionworkspaces.delete
  • datamigration.conversionworkspaces.get
  • datamigration.conversionworkspaces.getIamPolicy
  • datamigration.conversionworkspaces.list
  • datamigration.conversionworkspaces.rollback
  • datamigration.conversionworkspaces.seed
  • datamigration.conversionworkspaces.setIamPolicy
  • datamigration.conversionworkspaces.update

您或許還可透過 自訂角色或其他 預先定義的角色取得這些權限。

內建編輯器的 Workspace

如要建立互動式轉換工作區並執行結構定義轉換，請按照下列步驟操作：

  1. 前往 Google Cloud 控制台的「轉換工作區」。

    前往轉換工作區

  2. 按一下「設定工作區」。
  3. 在「建立轉換工作區」頁面中，執行下列操作：
    1. 輸入轉換工作區的名稱、ID 和區域。
    2. 從「Source database engine」(來源資料庫引擎) 下拉式選單中，選取「Oracle」。
    3. 在「目的地資料庫引擎」部分，選取「PostgreSQL 適用的 Cloud SQL」。

    4. 在「為工作區啟用 Gemini 設定」 部分，勾選核取方塊即可啟用 Gemini 支援的轉換功能。您也可以在需要時啟用這些功能， 使用 Gemini 輔助功能轉換程式碼和結構定義。

      如要使用 Gemini 輔助轉換功能，必須啟用 Gemini for Google Cloud API。詳情請參閱「 採用 Gemini 的轉換功能」。

    5. 按一下「建立工作區並繼續」。
  4. 在「定義來源並提取結構定義快照」頁面中，執行下列操作：
    1. 在「來源連線設定檔」下拉式選單中，選取來源資料庫的連線設定檔。
    2. 按一下「提取結構定義快照並繼續」。

    資料庫遷移服務現在會連線至來源資料庫並擷取結構定義。 這項作業可能需要幾分鐘才能完成。

  5. 在「選取並轉換物件」頁面中，使用核取方塊選取要轉換為 PostgreSQL 語法的物件。

    您不必一次轉換所有物件，可以先選取幾個物件，然後 稍後再新增更多物件以進行轉換。

  6. 按一下「轉換並繼續」。

    轉換工作區隨即開啟。

  7. 首次開啟新工作區時，您可以升級工作區，存取 Gemini 支援的自動轉換功能。請按照下列步驟操作：
    • 在「隆重推出 Gemini 自動轉換功能」對話方塊中，勾選「將工作區升級，探索新服務」核取方塊，然後按一下「繼續」。
    • 在「要透過 Gemini 轉換來源物件嗎？」對話方塊中， 按一下「轉換」。

      資料庫移轉服務現在會再次執行轉換程序，在確定性轉換結果的基礎上，套用 Gemini 輔助轉換強化功能。如要進一步瞭解 Gemini 自動轉換功能，請參閱 Gemini 自動轉換。

舊版轉換工作區

舊版轉換工作區是較舊且功能較受限的轉換工作區。我們不建議在遷移作業中使用舊版轉換工作區。如需使用舊版轉換工作區，請展開「建立舊版轉換工作區並轉換結構定義」部分，瞭解詳情。

建立舊版轉換工作區並轉換結構定義

舊版轉換工作區使用 Ora2Pg 設定檔。 建立舊版轉換工作區前，請務必先在資料庫移轉服務外部建立 Ora2Pg 設定。詳情請參閱「 使用舊版轉換工作區」。

  1. 前往 Google Cloud 控制台的「轉換工作區」。

    前往轉換工作區

  2. 按一下「設定工作區」。
  3. 在「建立轉換工作區」頁面中，執行下列操作：
    1. 輸入轉換工作區的名稱、ID 和區域。
    2. 從「Source database engine」(來源資料庫引擎) 下拉式選單中，選取「Oracle」。
    3. 在「目的地資料庫引擎」部分，選取「PostgreSQL 適用的 Cloud SQL」。
    4. 展開「自訂工作區設定」部分，然後勾選「啟用舊版轉換工作區」核取方塊。
    5. 按一下「建立工作區並繼續」。
  4. 在「連結至來源並轉換物件」頁面中，執行下列操作：
    1. 在「來源連線設定檔」下拉式選單中，選取來源資料庫的連線設定檔。

    2. 在「設定檔」方塊中，按一下「瀏覽」，然後使用系統檔案挑選器選取轉換對應檔案。

      按一下「新增檔案」，即可上傳多個轉換對應檔案。

    3. 在「轉換設定」部分，按一下「提取結構定義並轉換」。

      資料庫遷移服務現在會連線至來源資料庫，根據轉換對應檔案中定義的規則，擷取結構定義並轉換為目的地 SQL 結構定義。這項作業可能需要幾分鐘才能完成。

  5. 按一下「儲存並關閉」。

    轉換工作區詳細資料頁面隨即開啟。

現在您可以將轉換後的結構定義套用至目的地資料庫。如果來源資料庫包含沒有主鍵的資料表，您也需要在套用轉換後的結構定義後，手動在目標資料庫的轉換資料表中建立主鍵限制。詳情請參閱「 使用舊版轉換工作區」。

後續步驟

您現在可以使用轉換工作區修正轉換問題、透過互動式編輯器修改物件，以及將轉換後的結構定義套用至目的地資料庫。請參閱「 將 Oracle 程式碼和結構定義轉換為 PostgreSQL 語法」。