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

透過集合功能整理內容 你可以依據偏好儲存及分類內容。

資料庫移轉服務會將 Gemini 整合至 Google Cloud 轉換工作區，協助您加快及改善轉換程序，包括：

• 透過 Gemini 輔助的自動轉換功能強化確定性轉換結果，運用 AI 的強大功能，大幅減少 PostgreSQL 程式碼中需要的手動調整次數。

  這項功能僅適用於已升級的轉換工作區。 只有新建的 Workspace 可升級。詳情請參閱「 升級轉換工作區」。

• 透過 轉換輔助程式提供程式碼可解釋性功能：一組專用提示，可協助您進一步瞭解轉換邏輯、提出轉換問題的修正方式，或最佳化轉換程式碼。

• 加快修正轉換問題的速度，使用 Gemini 程式碼轉換建議：Gemini 模型會在您修正轉換問題時學習，並建議變更工作區中的其他錯誤物件。

  您也可以將這項功能與程式碼可解釋性結合，享有完整的端對端 Gemini 輔助程式碼物件轉換體驗。詳情請參閱 修正含有轉換問題的程式碼物件工作流程範例。

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

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

費用

如要在資料庫移轉服務轉換工作區中使用 Gemini 協助功能，您必須啟用 Gemini for Google Cloud API。須支付 Gemini 的價格。詳情請參閱 Gemini for Google Cloud 定價。

事前準備

如要在資料庫移轉服務中使用 Gemini 技術輔助功能，請按照下列步驟操作：

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

   啟用 API

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

   啟用或停用各項 Gemini 技術輔助功能，也取決於您是否使用 升級的轉換工作區。如要進一步瞭解如何啟用或停用各項功能，請參閱本頁的後續章節。

使用 Gemini 自動轉換功能

轉換來源結構定義時，資料庫移轉服務會使用確定性的轉換規則，建立 PostgreSQL 語法等價項目。自動轉換功能會在確定性結果上整合 Gemini 修正項目，藉此減少轉換問題的數量並改善轉換品質。

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

1. 建立新的轉換工作區。請務必立即升級，以便使用最新的簡化體驗。
2. 前往「轉換工作區」，然後選取工作區。

   前往「轉換工作區」

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

   資料庫移轉服務會自動在轉換作業中採用 Gemini 提供的強化功能。您可以使用樹狀檢視畫面查看哪些物件已透過 Gemini 強化：

   

5. 在樹狀檢視畫面中選取任何擴增物件，即可查看自動轉換功能提供的強化功能詳細資料。如果您不喜歡 Gemini 所做的變更，請按一下「改用確定性程式碼」，將物件還原為確定性轉換結果。

   

啟用自動轉換功能

如果先前已停用自動轉換功能，可以在 Gemini 面板中啟用：

1. 在 Google Cloud 控制台中前往「轉換工作區」，然後選取工作區。

   前往「轉換工作區」

2. 按一下「pen_spark」pen_sparkGemini「Gemini」。

   Gemini 側邊面板會隨即開啟。

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

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

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

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

停用自動轉換

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

1. 在 Google Cloud 控制台中前往「轉換工作區」，然後選取工作區。

   前往「轉換工作區」

2. 按一下「pen_spark」pen_sparkGemini「Gemini」。

   Gemini 側邊面板會隨即開啟。

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

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

4. 選用步驟：在「Convert source objects?」對話方塊中，按一下「Convert」。

   停用自動轉換功能後，系統不會修改已轉換的物件。如果您想將轉換結果還原為使用確定轉換規則，可以稍後再轉換結構定義。

使用 Gemini 轉換輔助工具

轉換輔助程式是一組專用提示，可讓您進一步瞭解物件轉換邏輯、提出如何最佳化程式碼和修正轉換問題的想法，甚至為自記錄資料庫物件新增結構定義註解。

啟用轉換輔助工具

在專案中啟用 Gemini for Google Cloud 時，系統會預設啟用轉換輔助工具。如果先前已停用轉換輔助工具，您可以在工作區中重新啟用該工具。啟用轉換輔助工具的步驟會因您是否使用升級版轉換工作區而有所不同。

停用轉換輔助工具

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

幫我解決物件轉換問題

當您將物件從 Oracle 轉換為 PostgreSQL 時，以規則為基礎的程式碼和結構轉換引擎可能會遇到問題。舉例來說，某些 Oracle 函式在 PostgreSQL 中可能沒有直接對應的函式。您可以使用「Help me fix object conversion issues」提示，取得可修正轉換問題的程式碼變更建議。

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

如要使用這個提示，請按照下列步驟操作：

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. 在結果面板中，請詳閱說明、查看程式碼，並確認建議內容是否符合您的需求。如果您滿意結果，可以使用「插入建議」按鈕更新轉換的物件。

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

「Add comments to explain the purpose of this object」提示會產生程式碼註解提案，您可以將這些註解新增至資料庫物件，以便自行記錄結構定義。

如要使用這個提示，請按照下列步驟操作：

1. 前往 Google Cloud 控制台的「Conversion workspaces」。

   前往「轉換工作區」

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

   轉換工作區編輯器隨即開啟。

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

4. 在物件詳細資料檢視畫面中，依序選取「轉換輔助工具」「新增註解來說明這個物件的用途」。

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

5. 在結果面板中，請詳閱說明、查看程式碼，並確認建議內容是否符合您的需求。如果您滿意結果，可以使用「插入建議」按鈕更新轉換的物件。

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

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

啟用 Gemini 轉換建議

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

停用 Gemini 轉換建議

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

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

修正物件問題 (透過編輯 SQL 物件的程式碼，或套用「 Help me fix object conversion issues」提示提供的程式碼) 後，Gemini 模型會分析變更內容。完成足夠的變更後，Gemini 整合會顯示提示，並建議進一步編輯。

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

1. 前往 Google Cloud 控制台的「Conversion workspaces」。

   前往「轉換工作區」

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

   轉換工作區編輯器隨即開啟。

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

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

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

   

5. 如要查看 AI 系統根據您所做的變更所產生的建議，請按一下「查看建議」。

查看 Gemini 轉換建議

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

「Fix issues with Gemini」頁面會顯示物件原始碼的三種變化版本，您可以在「Edit view」選單中選取：

• 原始原始碼 (唯讀)
• 草稿目的地原始碼 (唯讀)
• 透過 Gemini 輔助功能產生的目的地原始碼 (可編輯)

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

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

1. 按一下物件，即可顯示 AI 建議的相關修正方式。
2. 查看並編輯 Gemini 模型建議的程式碼。

3. 執行下列其中一個步驟：

   • 如要接受建議 (包括您所做的編輯)，請按一下「接受程式碼」。變更會套用至轉換工作區中的物件，物件清單中的物件狀態也會從「Pending」變更為「Accepted」。

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

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

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

1. 在「修正 Gemini 問題」頁面上，按一下返回箭頭。

2. 在「關閉 Gemini」對話方塊中，按一下「關閉」。

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

後續步驟

• 瞭解如何使用 轉換工作區。

• 閱讀「 Gemini for Google Cloud 總覽」。

• 瞭解 Gemini 如何使用您的資料。

• 請按照 範例工作流程修正轉換問題。