透過 Gemini 協助轉換 Oracle 程式碼和結構定義

資料庫移轉服務已將 Gemini for Google Cloud 整合至 轉換工作區,協助您加快轉換程序,並提升下列領域的轉換成效:

SQL 程式碼和結構定義會儲存在您建立轉換工作區的區域。如果您使用 Gemini 模型輔助轉換程式碼和結構定義,系統可能會在其他地區處理您的程式碼和結構定義。

瞭解 Gemini for Google Cloud 如何使用您的資料,以及使用時機

費用

如要在資料庫移轉服務轉換工作區中使用 Gemini 輔助功能,請啟用 Gemini for Google Cloud API。須支付 Gemini 費用。詳情請參閱「 Gemini for Google Cloud 定價」。

如要在資料庫移轉服務中使用 Gemini 驅動的功能,請按照下列步驟操作:

  1. 在專案中啟用 Gemini for Google Cloud 。

    啟用 API

  2. 為專案啟用 Gemini 後,系統會自動為專案中的所有轉換工作區啟用 Google Cloud 轉換助理 模式比對。如要使用 自動轉換,必須為每個工作區啟用這項功能。

    啟用或停用各項 Gemini 支援功能,也取決於您是否使用 升級版轉換工作區。如要進一步瞭解如何啟用或停用各項功能,請參閱本頁面的下一節。

事前準備

如要在資料庫移轉服務中使用 Gemini 驅動的功能,請按照下列步驟操作:

  1. 在專案中啟用 Gemini for Google Cloud 。

    啟用 API

  2. 為專案啟用 Gemini 後,系統會自動為專案中的所有轉換工作區啟用 Google Cloud 轉換助理 模式比對。如要使用 自動轉換,必須為每個工作區啟用這項功能。

    啟用或停用各項 Gemini 支援功能,也取決於您是否使用 升級版轉換工作區。如要進一步瞭解如何啟用或停用各項功能,請參閱本頁面的下一節。

必要的角色

如要取得使用 Gemini 強化轉換功能所需的權限,請要求管理員為您授予專案的 資料庫移轉管理員 (roles/datamigration.admin) 角色。

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

這個預先定義的角色具備使用 Gemini 強化轉換功能所需的權限。如要查看確切的必要權限,請展開「必要權限」部分:

所需權限

如要使用資料庫移轉服務執行異質 SQL Server 遷移作業,您必須具備下列權限:

  • datamigration.*
  • cloudaicompanion.entitlements.get

使用 Gemini 自動轉換功能

轉換來源結構定義時,資料庫移轉服務會使用確定性轉換規則,建立 PostgreSQL 等效語法。自動轉換功能會整合 Gemini 輔助修正功能,並以確定性結果為基礎,減少轉換問題數量並提升轉換品質。

如要使用自動轉換功能,請按照下列步驟操作:

  1. 建立新的轉換工作區。請立即升級,體驗最新簡化版服務。
  2. 前往「轉換工作區」,然後選取您的工作區。

    前往轉換工作區

  3. 為工作區啟用自動轉換功能
  4. 轉換原始碼和結構定義。按一下「轉換來源」

    資料庫移轉服務會在轉換過程中自動採用 Gemini 輔助的強化功能。您可以使用樹狀結構檢視畫面,查看哪些物件經過 Gemini 強化:

    轉換樹狀檢視畫面,以及 Gemini 輔助摘要。
    圖 1. 來源結構定義樹狀檢視畫面,顯示 Gemini 擴增狀態。(按一下即可放大)
    轉換樹狀檢視畫面,以及 Gemini 輔助摘要。
  5. 在樹狀檢視畫面中,選取任何經過強化的物件,即可查看自動轉換提供的強化詳細資料。如果不喜歡 Gemini 導入的變更,請按一下「改用確定性程式碼」,將物件還原為確定性轉換結果。

    Gemini 支援的自動轉換面板,其中會顯示轉換後結構定義的調整項目詳細資料。
    圖 2. 由 Gemini 支援的自動轉換面板,可檢查程式碼和結構定義增強功能的詳細資料。(按一下即可放大)
    Gemini 支援的自動轉換面板,其中會顯示轉換後結構定義的調整項目詳細資料。

啟用自動轉換功能

如果先前停用了自動轉換功能,可以透過 Gemini 面板啟用:

  1. 前往 Google Cloud 控制台的「Conversion workspaces」(轉換工作區) ,然後選取您的工作區。

    前往轉換工作區

  2. 依序點選「pen_sparkGemini「Gemini」。

    Gemini 側邊面板隨即開啟。

  3. 選取「自動轉換」核取方塊,然後按一下「儲存設定」

    轉換結構定義時,轉換工作區現在會自動轉換。

  4. 選用步驟:在「要透過 Gemini 轉換來源物件嗎?」對話方塊中, 按一下「轉換」

    啟用自動轉換後,系統不會修改轉換後的物件。 您之後可以再次 轉換結構定義

停用自動轉換

如要停用自動轉換功能,請按照下列步驟操作:

  1. 前往 Google Cloud 控制台的「Conversion workspaces」(轉換工作區) ,然後選取您的工作區。

    前往轉換工作區

  2. 依序點選「pen_sparkGemini「Gemini」。

    Gemini 側邊面板隨即開啟。

  3. 取消勾選「自動轉換」核取方塊,然後按一下「儲存設定」

    轉換結構定義時,轉換工作區會使用確定性程式碼和結構定義轉換。

  4. 選用步驟:在「要轉換來源物件嗎?」對話方塊中,按一下「轉換」

    停用自動轉換後,系統不會修改轉換後的物件。 如要將轉換結果還原為使用確定性轉換規則,可以稍後再次轉換結構定義。

使用 Gemini 轉換助理

轉換助理是一組專用提示,可用於深入瞭解物件轉換邏輯、詢問如何最佳化程式碼和修正轉換問題,甚至在結構定義中新增註解,為資料庫物件自行編寫說明文件。

螢幕截圖:顯示如何存取 Gemini 提示,瞭解程式碼和結構定義轉換的說明。
圖 1. Gemini 轉換助理提示。(按一下即可放大)
螢幕截圖:顯示如何存取 Gemini 提示,瞭解程式碼和結構定義轉換的說明。

啟用轉換助理

在專案中啟用 Gemini for Google Cloud 時,系統預設會啟用轉換助理。如果先前停用了轉換助理,可以在工作區中重新啟用。啟用轉換助理的步驟會因您是否使用升級版轉換工作區而異。

升級的工作區

如要在升級後的轉換工作區啟用轉換助理,請按照下列步驟操作:

  1. 前往 Google Cloud 控制台的「Conversion workspaces」(轉換工作區) ,然後選取您的工作區。

    前往轉換工作區

  2. 依序點選「pen_sparkGemini

    Gemini 側邊面板隨即開啟。

  3. 選取「轉換輔助」核取方塊,然後按一下「儲存設定」

未升級的工作區

如果舊版工作區尚未升級為使用 Gemini 自動轉換功能,只要 為專案啟用 Gemini,系統就會預設啟用轉換輔助功能。您不需要採取任何其他步驟。

停用轉換助理

啟用轉換助理的步驟會因您是否使用升級版轉換工作區而異。

升級的工作區

如要在升級後的轉換工作區中啟用轉換助理,請按照下列步驟操作:

  1. 前往 Google Cloud 控制台的「Conversion workspaces」(轉換工作區) ,然後選取您的工作區。

    前往轉換工作區

  2. 依序點選「pen_sparkGemini

    Gemini 側邊面板隨即開啟。

  3. 選取「轉換輔助」核取方塊,然後按一下「儲存設定」

未升級的工作區

如果舊版工作區尚未升級為使用 Gemini 自動轉換功能,只要 為專案啟用 Gemini,系統就會預設啟用轉換輔助功能。

如要停用轉換助理,請在專案中停用 Gemini for Google Cloud 。

幫我解決物件轉換問題

以規則為基礎的程式碼和結構定義轉換引擎,有時可能會在將物件從 Oracle 轉換為 PostgreSQL 時發生問題。舉例來說,某些 Oracle 函式可能沒有對應的 PostgreSQL 函式。你可以使用「幫我解決物件轉換問題」提示,取得可修正轉換問題的程式碼變更建議。

這項提示僅適用於有轉換問題的 可編輯程式碼物件。您無法在轉換工作區中查看其他類型物件的提示。

如要使用這項提示,請按照下列步驟操作:

  1. 前往 Google Cloud 控制台的「Conversion workspaces」(轉換工作區)

    前往轉換工作區

  2. 從可用的轉換工作區清單中,選取要使用的轉換工作區。

    系統會開啟轉換工作區編輯器。

  3. 在「Oracle」Oracle面板中,選取其中一個 Oracle 物件。

  4. 在物件詳細資料檢視畫面中,依序選取「轉換助理」>「幫我解決物件轉換問題」

    系統會開啟窗格,顯示提示結果。

  5. 確認差異畫面,當中會顯示建議的改善項目。如果對結果感到滿意,可以按一下「插入建議」按鈕,更新轉換後的物件。

  6. 針對每個有問題的程式碼物件重複上述步驟。套用程式碼提案時, Gemini 模型會學習模式,並建議如何將修正內容傳播至工作空間中的所有錯誤物件

說明這個物件的轉換邏輯

使用「說明這個物件的轉換邏輯」提示,即可取得轉換後程式碼的逐步說明,包括新程式碼中套用的最佳做法摘要。

如要要求說明物件轉換邏輯,請按照下列步驟操作:

  1. 前往 Google Cloud 控制台的「Conversion workspaces」(轉換工作區)

    前往轉換工作區

  2. 從可用的轉換工作區清單中,選取要使用的轉換工作區。

    系統會開啟轉換工作區編輯器。

  3. 在「Oracle」Oracle面板中,選取其中一個 Oracle 物件。

  4. 在物件詳細資料檢視畫面中,依序選取「轉換助理」>「說明這個物件的轉換邏輯」

    系統會開啟窗格,顯示提示結果。

幫我修改這段程式碼,以便發揮最大成效

有時,以規則為準的程式碼和結構定義轉換結果在技術上可能正確,但未針對 PostgreSQL 環境進行全面最佳化。您可以使用「幫我修改這段程式碼,以便發揮最大成效」提示,取得資料庫物件的最佳化程式碼建議。

如要使用這項提示,請按照下列步驟操作:

  1. 前往 Google Cloud 控制台的「Conversion workspaces」(轉換工作區)

    前往轉換工作區

  2. 從可用的轉換工作區清單中,選取要使用的轉換工作區。

    系統會開啟轉換工作區編輯器。

  3. 在「Oracle」Oracle面板中,選取其中一個 Oracle 物件。

  4. 在物件詳細資料檢視畫面中,依序選取「轉換助理」>「幫我最佳化這段程式碼」

    系統會開啟窗格,顯示提示結果。

  5. 在結果面板中閱讀說明、檢查程式碼,並確認建議內容符合您的需求。如果對結果感到滿意,可以按一下「插入建議」按鈕,更新轉換後的物件。

新增註解來說明這個物件的用途

「新增註解來說明這個物件的用途」提示會產生程式碼註解提案,您可以將這些註解新增至資料庫物件,以便自行記錄結構定義。

如要使用這項提示,請按照下列步驟操作:

  1. 前往 Google Cloud 控制台的「Conversion workspaces」(轉換工作區)

    前往轉換工作區

  2. 從可用的轉換工作區清單中,選取要使用的轉換工作區。

    系統會開啟轉換工作區編輯器。

  3. 在「Oracle」Oracle面板中,選取其中一個 Oracle 物件。

  4. 在物件詳細資料檢視畫面中,選取「轉換助理」>「新增註解來說明這個物件的用途」

    系統會開啟窗格,顯示提示結果。

  5. 在結果面板中閱讀說明、檢查程式碼,並確認建議內容符合您的需求。如果對結果感到滿意,可以按一下「插入建議」按鈕,更新轉換後的物件。

使用 Gemini 程式碼轉換功能,傳播轉換問題修正內容

在工作區修正轉換問題時,Gemini 模型可以從您的修正內容中學習,並建議變更工作區中的其他錯誤物件。這樣一來,您就能將修正內容傳播至多個物件,而不必手動進行所有編輯。

啟用 Gemini 轉換建議

在專案中啟用 Gemini for Google Cloud 時,系統預設會啟用轉換建議。如果先前停用這項功能,可以在工作區中重新啟用。啟用轉換建議的步驟會因您是否使用升級版轉換工作區而異。

升級的工作區

如要在升級後的轉換工作區中啟用轉換助理,請按照下列步驟操作:

  1. 前往 Google Cloud 控制台的「Conversion workspaces」(轉換工作區) ,然後選取您的工作區。

    前往轉換工作區

  2. 依序點選「pen_sparkGemini

    Gemini 側邊面板隨即開啟。

  3. 勾選「模式比對」核取方塊,然後按一下「儲存設定」

未升級的工作區

如果舊版工作區尚未升級為使用 Gemini 自動轉換功能,當您 為專案啟用 Gemini 後,系統預設會啟用轉換建議。如果先前停用了轉換建議,請按照下列步驟重新啟用:

  1. 前往 Google Cloud 控制台的「Conversion workspaces」(轉換工作區) ,然後選取您的工作區。

    前往轉換工作區

  2. 在工作列中,按一下「pen_spark Gemini」,然後選取「程式碼建議」

    這個轉換工作區現已啟用 Gemini 程式碼轉換建議。

停用 Gemini 轉換建議

啟用轉換助理的步驟會因您是否使用升級版轉換工作區而異。

升級的工作區

如要在升級後的轉換工作區中啟用轉換建議,請按照下列步驟操作:

  1. 前往 Google Cloud 控制台的「Conversion workspaces」(轉換工作區) ,然後選取您的工作區。

    前往轉換工作區

  2. 依序點選「pen_sparkGemini

    Gemini 側邊面板隨即開啟。

  3. 取消勾選「模式比對」核取方塊,然後按一下「儲存設定」

未升級的工作區

如要停用舊版工作區的轉換建議 (這些工作區尚未升級以使用 Gemini 自動轉換功能),請按照下列步驟操作:

  1. 前往 Google Cloud 控制台的「Conversion workspaces」(轉換工作區) ,然後選取您的工作區。

    前往轉換工作區

  2. 在工作列中,按一下「pen_spark Gemini」,然後選取「程式碼建議」

    這個轉換工作區已停用 Gemini 程式碼轉換建議。

在資料庫移轉服務中查看 Gemini 轉換建議

修正物件問題時 (編輯 SQL 物件的程式碼,或套用「 幫我解決物件轉換問題」提示建議的程式碼),Gemini 模型會分析您的變更。完成足夠的變更後,Gemini 整合功能會顯示提示,並建議進一步編輯。

如何查看 Gemini 建議:

  1. 前往 Google Cloud 控制台的「Conversion workspaces」(轉換工作區)

    前往轉換工作區

  2. 從可用的轉換工作區清單中,選取要使用的轉換工作區。

    系統會開啟轉換工作區編輯器。

  3. 在「Oracle」Oracle面板中,選取要調整所產生 SQL 的物件。

  4. 修正物件遇到的轉換問題,並儲存程式碼變更。 您可以 手動編輯程式碼,或使用「 幫我解決物件轉換問題」提示。

    Gemini 模型會分析您最近的修正項目,直到可以建議其他有轉換問題的物件進行類似更新為止。Gemini 模型分析足夠的修正內容後,系統會顯示「查看 Gemini 的建議」對話方塊。

    Gemini 建議修正問題對話方塊。
    圖 2. Gemini 建議修正問題對話方塊。 (按一下即可放大)
    Gemini 建議修正問題對話方塊。
  5. 如要查看 AI 根據您所做變更生成的建議,請按一下「查看建議」

查看 Gemini 轉換建議

「使用 Gemini 修正問題」頁面會顯示 Gemini 模型根據您所做的程式碼變更生成的建議。這些建議包含類似的變更,可套用至其他物件。您可以查看、變更、接受或忽略每項建議。

「使用 Gemini 修正問題」頁面會顯示物件原始碼的三種變體,您可以在「編輯檢視畫面」選單中選取:

  • 原始原始碼 (唯讀)
  • 目的地原始碼草稿 (唯讀)
  • 在 Gemini 輔助下生成的目的地原始碼 (可編輯)

「物件」窗格會列出有問題的物件,以及 Gemini 模型建議的修正方式。

如要查看 Gemini 建議,請按照下列步驟操作:

  1. 按一下物件,即可顯示相關的 AI 建議修正內容。
  2. 查看及編輯 Gemini 模型建議的程式碼。
  3. 執行下列其中一個步驟:

    • 如要接受建議 (包括編輯內容),請按一下「接受程式碼」。 變更會套用至轉換工作區中的物件,而物件清單中的物件狀態會從「待處理」變更為「已接受」

    • 如要保留建議 (包括編輯內容),但不要套用變更,請切換至其他物件。物件會維持「待處理」狀態。您可以編輯程式碼,然後接受或忽略建議。

    • 如要忽略待處理或已接受的建議 (並還原編輯內容),請按一下「忽略程式碼」。物件清單中的物件狀態會從「待處理」變更為「已忽略」。系統已還原您的變更。 您可以編輯代碼,稍後再套用。

如要關閉 Gemini 建議並捨棄所有未套用的變更,請按照下列步驟操作:

  1. 在「使用 Gemini 修正問題」頁面中,按一下返回箭頭。
  2. 在「關閉 Gemini」對話方塊中,按一下「關閉」

    目前的 Gemini 工作階段已關閉。如要返回建議頁面,請再次 存取 Gemini 建議

後續步驟