SQL Server 移轉助理（SSMA）中的 Copilot 藉由提供智慧型、人工智慧驅動的協助，以增強從 Oracle 到 SQL 的程式碼轉換過程，特別針對複雜或不支援的物件。 當 SSMA 規則引擎遇到轉換挑戰時，例如語法差異、專屬 Oracle 功能或不支援的數據類型時，Copilot 會逐步分析問題、說明根本原因，以及產生替代的 SQL 相容程式代碼。
藉由與 Azure OpenAI 整合，SSMA for Oracle 中的 Copilot（預覽版）可讓您直接在 SSMA 介面內檢閱、精簡及驗證建議的程式代碼，簡化移轉程式，並減少手動工作。
先決條件
若要在 SSMA for Oracle 中使用 Copilot 進行程式代碼轉換，請確定您有下列 Azure OpenAI 資源詳細數據：
- Azure OpenAI 端點網址 URL
- Azure OpenAI 部署
- 模型名稱
- Azure OpenAI 金鑰
如果您沒有這些詳細數據，請遵循 如何建立 Azure OpenAI 資源 一節中的步驟。
在 SSMA for Oracle 中執行 Copilot 的步驟 （預覽）
程式代碼轉換完成後，SSMA 規則引擎無法轉換的目標對象、顯示警告或錯誤。 針對這些物件，您可以啟動 Copilot 修復功能。
如果未註冊 OpenAI 資源，您需要完成下列欄位：
- Azure OpenAI 端點網址 URL
- Azure OpenAI 部署
- 模型名稱
- Azure OpenAI 金鑰
![[驗證端點] 對話框的螢幕快照。](media/copilot-in-ssma-overview/validate-endpoint.png?view=sql-server-ver16)
驗證成功之後，您就可以檢視轉換的程序代碼。 產生轉換的程式代碼需要幾分鐘的時間。 產生程式代碼之後，您可以檢閱建議的變更。
程式代碼轉換介面
[程式代碼轉換] 視窗有三個區段：
| 章節 | 說明 |
|---|---|
| 要修正的錯誤 | 本節說明識別的可能問題，或修正 SSMA 規則引擎無法轉換或無法剖析 PL/SQL 語句的錯誤。 |
| 說明 | 提供轉換問題的根本原因、描述其建議背後的邏輯，並提供清楚、內容相關的深入解析，以協助您瞭解並驗證產生的 Transact-SQL 程序代碼。 |
| 程式代碼檢閱視窗 | 可讓您檢視 SSMA 產生的和 Copilot 轉換程式代碼之間的並存差異。 它會醒目提示變更，讓您在接受建議之前評估改進、瞭解修改，以及做出明智的決策。 |
如果對轉換不滿意，您可以在提示中重試或傳送其他資訊。 如果轉換的程式代碼適合，您可以接受建議。
管理 IDE 中已接受的變更
檢閱並接受 Copilot 產生的程式代碼之後，您可以在 SSMA IDE 中找到已接受的變更。 請遵循下列步驟來儲存和同步處理您的資料庫變更：
- 瀏覽至顯示已接受變更的 SSMA IDE。
- 儲存變更以確保它們儲存在本機。
- 使用同步處理功能，將變更復寫至您的資料庫。
修改 Azure OpenAI 設定
如果您需要變更 Azure OpenAI 詳細數據，請移至 SSMA 功能表中 的 [工具>項目設定>] [Copilot ]。 視需要更新 Azure OpenAI 端點、 Azure OpenAI 部署、 模型名稱和Azure OpenAI 密鑰 。
檢閱和驗證
由於此程式代碼是由 AI 產生，因此在接受或儲存變更之前，請務必先檢閱、驗證及測試變更。 請確定程式代碼符合您的需求，並在您的環境中正確運作。
局限性
數據表和使用者定義數據類型的 Copilot 產生的程式代碼無法直接儲存在 SSMA 中。 在這種情況下，SSMA 會提供下載選項，在本機儲存 Copilot 產生的程式代碼。