資料庫遷移服務將 Gemini for Google Cloud 整合至 轉換工作區，協助您在下列領域加快及改善轉換程序：
-
使用 Gemini 輔助自動轉換功能，強化確定性轉換結果，運用 AI 大幅減少 PostgreSQL 程式碼所需的手動調整次數。
- 提供程式碼可解釋性功能，並附上 轉換助理：這是一組專用提示詞，可協助您進一步瞭解轉換邏輯、提出轉換問題修正建議，或最佳化轉換後的程式碼。
- 使用 Gemini 品質評估功能驗證轉換後的程式碼。Gemini 可協助分析轉換後的程式碼，確保其正確性及功能與原始程式碼相同。
-
加快修正轉換問題：Gemini 程式碼轉換建議機制可讓 Gemini 模型在您修正轉換問題時學習，並建議對工作區中其他有問題的物件進行變更。
您也可以將這項功能與程式碼可解釋性功能搭配使用，享有完整的端對端 Gemini 程式碼物件轉換體驗。詳情請參閱「 修正有轉換問題的程式碼物件範例工作流程」。
SQL 程式碼和結構定義會儲存在您建立轉換工作區的區域。如果您使用 Gemini 模型輔助轉換程式碼和結構定義，系統可能會在其他區域處理您的程式碼和結構定義。
瞭解 Gemini for Google Cloud 如何使用您的資料。
費用
如要在資料庫遷移服務轉換工作區中使用 Gemini 輔助功能，請啟用 Gemini for Google Cloud API。Gemini 適用定價。詳情請參閱「 Gemini for Google Cloud 定價」。
事前準備
如要在資料庫遷移服務中使用 Gemini 輔助功能，請在專案中啟用 Gemini for Google Cloud 。
在專案中啟用 Gemini for Google Cloud 後，即可在工作區使用所有 Gemini 輔助轉換功能。
必要的角色
如要取得使用 Gemini 強化轉換功能所需的權限，請要求管理員授予您專案的
資料庫移轉管理員 (roles/datamigration.admin) 角色。
如要進一步瞭解如何授予角色，請參閱 Identity and Access Management 說明文件中的「 管理存取權」。
這個預先定義的角色具備使用 Gemini 強化轉換功能所需的權限。如要查看確切的必要權限，請展開「Required permissions」(必要權限) 部分：
所需權限
如要使用資料庫遷移服務執行異質 SQL Server 遷移作業，必須具備下列權限：
datamigration.*cloudaicompanion.entitlements.get
使用 Gemini 自動轉換功能
轉換來源結構定義時，資料庫遷移服務會使用確定性轉換規則，建立對等的 PostgreSQL 語法。自動轉換功能會在確定性結果之上，整合 Gemini 輔助修正功能，減少轉換問題並提升轉換品質。
您可以對 Gemini 修正後的程式碼物件，進行額外的品質和功能等效評估。詳情請參閱「 Gemini 品質評估」。
如要使用自動轉換功能，請按照下列步驟操作：
- 建立新的轉換工作區。請務必立即升級，以便使用最新的精簡體驗。
- 前往「Conversion workspaces」(轉換工作區)，然後選取工作區。
- 為工作區啟用自動轉換功能。
- 轉換原始碼和結構定義。按一下 「Convert source」(轉換來源)。
資料庫遷移服務會自動在轉換作業中，採用 Gemini 輔助強化功能。您可以使用樹狀檢視畫面，查看哪些物件經過 Gemini 強化：
圖 1. 來源結構定義樹狀檢視畫面，顯示 Gemini 擴增狀態。(按一下可放大)
在樹狀檢視畫面中，選取任何經過強化的物件，即可查看自動轉換提供的強化功能詳細資料。如果不喜歡 Gemini 導入的變更，請按一下「Use deterministic code instead」，將物件還原為確定性轉換結果。
圖 2. Gemini 輔助的自動轉換面板，可讓您查看程式碼和結構定義增強功能的詳細資料。(按一下可放大)
啟用自動轉換
如果先前已停用自動轉換功能，可以在 Gemini 面板中啟用：
- 前往 Google Cloud 控制台的「Conversion workspaces」(轉換工作區)，然後選取工作區。
- 按一下 pen_spark「Gemini」Gemini。
Gemini 側邊面板隨即開啟。
- 勾選「自動轉換」核取方塊，然後按一下「儲存設定」。
轉換結構定義時，轉換工作區會自動轉換。
- 選用：在「Convert source objects with Gemini?」(要透過 Gemini 轉換來源物件嗎？) 對話方塊中，按一下「Convert」(轉換)。
啟用自動轉換功能後，轉換後的物件不會遭到修改。 您之後可以再次 轉換結構定義。
停用自動轉換
如要停用自動轉換功能，請按照下列步驟操作：
- 前往 Google Cloud 控制台的「Conversion workspaces」(轉換工作區)，然後選取工作區。
- 按一下 pen_spark「Gemini」Gemini。
Gemini 側邊面板隨即開啟。
- 取消勾選「自動轉換」核取方塊，然後按一下「儲存設定」。
轉換結構定義時，轉換工作區會使用確定性程式碼和結構定義轉換。
- 選用：在「Convert source objects?」(要轉換來源物件嗎？) 對話方塊中，按一下「Convert」(轉換)。
停用自動轉換功能後，已轉換的物件不會遭到修改。 如要將轉換結果還原為使用確定性轉換規則，可以稍後再次轉換結構定義。
使用 Gemini 轉換助理
轉換助理是一組專用提示，可協助您進一步瞭解物件轉換邏輯、取得最佳化程式碼和解決轉換問題的建議，甚至還能為結構定義新增註解，建立自我記錄的資料庫物件。
啟用轉換助理
在專案中啟用 Gemini for Google Cloud 時，轉換助理預設會啟用。如果您先前停用了轉換輔助工具，可以在工作區中重新啟用。如要啟用轉換助理，請按照下列步驟操作：
- 前往 Google Cloud 控制台的「Conversion workspaces」(轉換工作區)，然後選取工作區。
- 按一下 pen_spark「Gemini」Gemini。
Gemini 側邊面板隨即開啟。
- 勾選「轉換輔助」核取方塊，然後按一下「儲存設定」。
停用轉換助理
如要停用轉換助理，請按照下列步驟操作：
- 前往 Google Cloud 控制台的「Conversion workspaces」(轉換工作區)，然後選取工作區。
- 按一下 pen_spark「Gemini」Gemini。
Gemini 側邊面板隨即開啟。
- 勾選「轉換輔助」核取方塊，然後按一下「儲存設定」。
幫我解決物件轉換問題
將物件從 Oracle 轉換為 PostgreSQL 時，規則式程式碼和結構定義轉換引擎有時可能會發生問題。舉例來說，某些 Oracle 函式在 PostgreSQL 中可能沒有直接對應的函式。您可以使用「Help me fix object conversion issues」(幫我解決物件轉換問題) 提示，取得可修正轉換問題的程式碼變更建議。
這則提示僅適用於有轉換問題的 可編輯程式碼物件。轉換工作區中的其他類型物件不會顯示這則提示。
如要使用這則提示，請按照下列步驟操作：
前往 Google Cloud 控制台的「Conversion workspaces」(轉換工作區)。
從可用轉換工作區清單中，選取要使用的轉換工作區。
轉換工作區編輯器隨即開啟。
在「Oracle」Oracle面板中，選取其中一個 Oracle 物件。
在物件詳細資料檢視畫面中，依序選取
「Assist」>「幫我解決物件轉換問題」。系統會開啟窗格，顯示提示結果。
查看顯示建議改善項目的差異畫面。如果對結果滿意，可以使用「Insert suggestion」(插入建議) 按鈕更新轉換後的物件。
為每個錯誤代碼物件重複上述步驟。套用程式碼建議時， Gemini 模型會學習模式，並提供建議，說明如何將修正項目套用至工作區中的所有錯誤物件。
說明這個物件的轉換邏輯
使用「Explain the conversion logic for this object」(說明這個物件的轉換邏輯) 提示，即可逐步瞭解轉換後的程式碼作用，包括新程式碼採用的最佳做法摘要。
如要要求說明物件轉換邏輯，請按照下列步驟操作：
前往 Google Cloud 控制台的「Conversion workspaces」(轉換工作區)。
從可用轉換工作區清單中，選取要使用的轉換工作區。
轉換工作區編輯器隨即開啟。
在「Oracle」Oracle面板中，選取其中一個 Oracle 物件。
在物件詳細資料檢視畫面中，依序選取
「Assist」>「Explain the conversion logic for this object」。系統會開啟窗格，顯示提示結果。
幫我修改這段程式碼，以便發揮最大成效
有時，以規則為基礎的程式碼和結構定義轉換結果在技術上可能正確，但未針對 PostgreSQL 環境完全最佳化。您可以使用「Help me optimize this code」(幫我盡可能改良這段程式碼) 提示，取得資料庫物件的程式碼最佳化建議。
如要使用這則提示，請按照下列步驟操作：
前往 Google Cloud 控制台的「Conversion workspaces」(轉換工作區)。
從可用轉換工作區清單中，選取要使用的轉換工作區。
轉換工作區編輯器隨即開啟。
在「Oracle」Oracle面板中，選取其中一個 Oracle 物件。
在物件詳細資料檢視畫面中，依序選取
「Assist」「幫我盡可能改良這段程式碼」。系統會開啟窗格，顯示提示結果。
在結果面板中，閱讀說明、查看程式碼，並確認提案符合您的需求。如果對結果滿意，可以使用「Insert suggestion」(插入建議) 按鈕更新轉換後的物件。
新增註解來說明這個物件的用途
「新增註解來說明這個物件的用途」提示會產生程式碼註解建議，您可以將這些註解新增至資料庫物件，用於自我記錄結構定義。
如要使用這則提示，請按照下列步驟操作：
前往 Google Cloud 控制台的「Conversion workspaces」(轉換工作區)。
從可用轉換工作區清單中，選取要使用的轉換工作區。
轉換工作區編輯器隨即開啟。
在「Oracle」Oracle面板中，選取其中一個 Oracle 物件。
在物件詳細資料檢視畫面中，依序選取
「Assist」>「Add comments to explain the purpose of this object」。提示結果窗格隨即開啟。
在結果面板中，閱讀說明、查看程式碼，並確認提案符合您的需求。如果對結果滿意，可以使用「Insert suggestion」(插入建議) 按鈕更新轉換後的物件。
運用 Gemini 品質評估功能，確保轉換品質
Gemini 可協助您評估程式碼和結構定義轉換作業的輸出內容品質。這些評估著重於驗證轉換後程式碼的功能等效性 (也就是確保 PostgreSQL 程式碼產生的結果與來源 SQL Server 程式碼相同)，但報告也會提供整體轉換品質的詳細意見回饋。如果程式碼有任何問題，系統會顯示新的轉換問題。
您可以為工作區設定自動品質評估，或手動執行所選物件的報表。
啟用自動品質評估
您可以設定轉換工作區，自動對符合條件的程式碼物件執行 Gemini 品質評估。如要使用這項功能，您也必須啟用 Gemini 自動轉換。
如要設定自動品質評估，請按照下列步驟操作：
- 前往 Google Cloud 控制台的「Conversion workspaces」(轉換工作區)，然後選取工作區。
- 按一下 pen_spark「Gemini」Gemini。
Gemini 側邊面板隨即開啟。
- 勾選「轉換品質評估」核取方塊，然後按一下「儲存設定」。
現在，資料庫遷移服務會自動為轉換後的物件建立品質評估報告。
執行手動品質評估報告
您可以視需要，對使用 Gemini 自動轉換功能轉換的任何支援程式碼物件，執行品質評估。
如何執行手動品質評估：
- 前往 Google Cloud 控制台的「Conversion workspaces」(轉換工作區)，然後選取工作區。
-
在轉換工作區編輯器中，使用來源面板選取要透過 Gemini 轉換的物件。
您可以使用
Augmented by Gemini篩選器，輕鬆瀏覽。詳情請參閱「 在來源結構定義檢視畫面中篩選物件」。 - 在「Conversion details」(轉換詳細資料) 面板中，選取「Quality assessment report」(品質評估報告) 分頁標籤，然後按一下「Assess the quality of this code」(評估這段程式碼的品質)。
- 評估作業會開始執行，結果會顯示在「Quality assessment report」(品質評估報告) 分頁中。
品質評估限制
- Gemini 品質評估功能僅支援透過 Gemini 自動轉換功能轉換的物件。
- 品質評估不支援結構定義物件。
- 評估重點主要在於功能等效性和整體品質。報告不含效能測試。
使用 Gemini 程式碼轉換功能，傳播轉換問題修正
在工作區修正轉換問題時，Gemini 模型會從修正內容中學習，並建議對工作區中其他有問題的物件進行變更。這樣一來，您就能將修正內容套用至多個物件，不必手動編輯所有物件。
啟用 Gemini 轉換建議
在專案中啟用 Gemini for Google Cloud 時，系統預設會啟用轉換建議。如果先前曾停用這項功能，可以在工作區中重新啟用。如要啟用轉換助理，請按照下列步驟操作：
- 前往 Google Cloud 控制台的「Conversion workspaces」(轉換工作區)，然後選取工作區。
- 按一下 pen_spark「Gemini」Gemini。
Gemini 側邊面板隨即開啟。
- 勾選「Pattern matching」(模式比對) 核取方塊，然後按一下「Save settings」(儲存設定)。
停用 Gemini 轉換建議
如要停用轉換建議，請按照下列步驟操作：
- 前往 Google Cloud 控制台的「Conversion workspaces」(轉換工作區)，然後選取工作區。
- 按一下 pen_spark「Gemini」Gemini。
Gemini 側邊面板隨即開啟。
- 取消勾選「Pattern matching」(模式比對) 核取方塊，然後按一下「Save settings」(儲存設定)。
在資料庫遷移服務中查看 Gemini 轉換建議
當您修正物件問題 (編輯 SQL 物件的程式碼，或套用「 幫我解決物件轉換問題」提示建議的程式碼)，Gemini 模型會分析變更。完成足夠的變更後，Gemini 整合功能會顯示提示，並建議進一步編輯。
如要查看 Gemini 建議，請按照下列步驟操作：
前往 Google Cloud 控制台的「Conversion workspaces」(轉換工作區)。
從可用轉換工作區清單中，選取要使用的轉換工作區。
轉換工作區編輯器隨即開啟。
在「Oracle」Oracle面板中，選取要調整生成 SQL 的物件。
修正物件轉換問題，並儲存程式碼變更。您可以 手動編輯程式碼，或使用「 幫我解決物件轉換問題」提示。
Gemini 模型會分析您最近的修正，直到能為其他有轉換問題的物件建議類似更新。Gemini 模型分析足夠的修正內容後，就會顯示「Review suggestions from Gemini」(查看 Gemini 的建議) 對話方塊。
圖 2. Gemini 修正問題對話方塊。 (按一下可放大)
如要查看 AI 根據您所做變更生成的建議，請按一下「查看建議」。
查看 Gemini 轉換建議
「Fix issues with Gemini」(使用 Gemini 修正問題) 頁面會根據您變更的程式碼，顯示 Gemini 模型生成的建議。這些建議包含可套用至其他物件的類似變更。您可以查看、變更、接受或忽略每項建議。
「Fix issues with Gemini」(使用 Gemini 修正問題) 頁面會顯示物件原始碼的三種變化版本，您可以在「Edit view」(編輯畫面) 選單中選取：
- 原始程式碼 (唯讀)
- 目的地原始碼草稿 (唯讀)
- 在 Gemini 協助下生成的目的地原始碼 (可編輯)
「Objects」(物件) 窗格會列出有問題的物件，以及 Gemini 模型建議的疑難排解建議。
如要查看 Gemini 建議，請按照下列步驟操作：
- 點按物件即可查看 AI 產生的相關修正建議。
- 查看並編輯 Gemini 模型建議的程式碼。
執行下列其中一個步驟：
如要接受建議 (包括您編輯的內容)，請按一下「Accept code」。變更會套用至轉換工作區中的物件，物件清單中的物件狀態會從「Pending」(待處理) 變更為「Accepted」(已接受)。
如要保留建議 (包括編輯內容)，但不套用變更，請切換至其他物件。物件會維持在「Pending」(待處理) 狀態。您可以編輯程式碼，並在之後接受或忽略建議。
如要忽略待處理或已接受的建議 (並還原編輯內容)，請按一下「Ignore code」(忽略程式碼)。物件清單中的物件狀態會從「Pending」(待處理) 變更為「Ignored」(已忽略)。變更已還原。 您可以編輯程式碼，稍後再套用。
如要關閉 Gemini 建議並捨棄所有未套用的變更，請按照下列步驟操作：
- 在「使用 Gemini 修正問題」頁面，點按返回箭頭。
在「關閉 Gemini」對話方塊中，點選「關閉」。
目前的 Gemini 工作階段已關閉。如要返回建議頁面，請再次 存取 Gemini 建議。
後續步驟
瞭解如何使用 轉換工作區。
瞭解 Gemini 如何使用您的資料。
請按照 範例工作流程，在 Gemini 協助下修正轉換問題。