Oracle 至 Azure PostgreSQL 的結構描述與應用程式轉換

Visual Studio Code 的 PostgreSQL 擴充功能提供 Oracle 架構與應用程式轉換的引導式工作流程。 架構轉換支援 適用於 PostgreSQL 的 Azure 資料庫 彈性伺服器 和 Azure HorizonDB,可用於架構驗證和部署。 本指南說明結構描述與應用程式工作流程如何整合。 請使用 schema 轉換教學 以完成完整的設定與轉換程序。 另行規劃資料列資料移轉。

Important

架構與應用程式轉換僅在 Visual Studio Code 中提供。

結構描述與應用程式轉換如何結合

若要進行結合架構與應用程式的轉換,請依序使用這兩個工作流程。 結構描述轉換會為您的資料庫物件產生 PostgreSQL 資料定義語言(DDL),而應用程式轉換則會更新呼叫這些物件的程式碼。 應用程式轉換也可以獨立執行。

模式轉換

結構描述轉換會讀取 Oracle 資料字典中的選定結構描述,並利用你的 Microsoft Foundry 部署來產生 PostgreSQL DDL。 該工具嘗試在結構驗證資料庫中編譯,並利用可用的靜態檢查來找出問題。 這些檢查並不能證明對等的執行階段行為或生產環境整備程度。 執行會產生:

  • 物件層級的 PostgreSQL .sql 檔案,依 postgres_ddlOracle 架構與物件類型組織。
  • 一份包含發現、擷取與轉換結果、轉換率及物件層級備註的 HTML 轉換報告。
  • 你可以在 Conversion 物件總管 檢查物件映射與備註,包括需要手動變更的物件。
  • 設定說明與腳本,使用 postgres_ddl 中的物件檔案進行獨立部署操作。
  • 說明結構描述中所發現之 Oracle 模式及其如何對應至 PostgreSQL 的程式碼附註。

應用程式轉換

應用程式轉換針對圍繞資料庫的 Oracle 專用程式碼:SQL 腳本、儲存程序呼叫、載入器控制檔案、shell 腳本及 Java 檔案。 若有提供,結構描述轉換產生的程式碼附註會引導物件名稱、類型和呼叫慣例的變更。 檢視並測試這些變更;產生的備註並不保證應用程式行為正確。

您可以在這個擴充功能中轉換與資料庫相關的應用程式程式碼,或將工作交給 GitHub Copilot 應用程式現代化擴充功能,進行完整的現代化流程。 轉換載入器腳本或其他應用程式檔案不會執行列資料遷移。

將兩個 pass 依序排列

若要進行合併的轉換工作流程,請先執行結構描述轉換,讓應用程式轉換可以使用其程式碼附註和轉換後的物件名稱。 在轉換應用程式碼前,請先檢視結構並解決必要的變更。 如果您之後編輯了 PostgreSQL 定義,請再次檢查它的應用程式呼叫端。 不支援重跑完成的結構轉換。

先決條件

若要進行結構描述轉換,請遵循下列項目的教學課程必要條件:

  • Visual Studio Code、PostgreSQL 擴充功能、支援的作業系統以及 Copilot 登入功能。
  • Oracle 版本、元資料權限、連線性及用戶端設定。
  • 架構驗證資料庫、PostgreSQL 版本、權限與擴充功能。
  • Foundry 模型、資源驗證和容量規劃。

在應用程式轉換時,也請先提供來源應用程式資料夾,並在接受產生的編輯前保留其原始內容。

啟用結構描述轉換

此設定控制pgsql.enableMigrations移轉檢視及其結構與應用程式轉換指令。 此設定預設為啟用狀態。 介面會保留像 Migrations 和 Create Migration Project 這樣的標籤來處理這些轉換工作流程。

如果提要欄位中沒有顯示 [移轉] 檢視,請開啟 Visual Studio Code 設定 (Windows/Linux 上為 Ctrl+,macOS 上為 Cmd+) 並確認 pgsql.enableMigrations 已設為 true。

建立結構轉換專案

專案精靈會收集您的來源、探索範圍、結構描述驗證資料庫連線和模型設定。 教學課程是主要的逐步解說;請使用下列進入點和連結來瀏覽。

步驟 1:專案設定

  1. 在側邊欄中開啟 [移轉] 檢視。

  2. 開始新專案的方式如下:

    • 如果工作區尚未包含結構描述轉換專案,請在檢視中選取 + Create Migration Project。
    • 選取檢視工具列中的 + 按鈕。
    • 在檔案總管中右鍵點擊一個工作區資料夾,選擇「開啟遷移專案」。
  3. 請在 Project 名稱欄位輸入名稱。

  4. 選擇 下一頁:Oracle Connection。

新的遷移 Project 頁面截圖,包含 Project 名稱欄位。

此截圖中的先決條件清單適用於 API 金鑰驗證。 您也可以使用 Microsoft Entra ID 驗證。

完成精靈程式

請依照每一頁對應的教學步驟操作:

精靈階段 指示
Oracle 連線和結構描述選取 連接 Oracle。
探索、來源權限與相依性 檢視 Discovery 結果。
結構描述驗證資料庫和擴充功能檢查 設定結構驗證資料庫。
Foundry 資源、模型和驗證 設定模型。

Warning

轉換會使用 DROP SCHEMA ... CASCADE 捨棄與所選 Oracle 結構描述對應的結構描述,然後再重新建立。 此動作會刪除該結構中現有的物件與資料,並可移除其他結構中的相依物件。 使用空白的結構驗證資料庫,或是專用且未使用的結構驗證資料庫,且不包含您需要保留的物件或資料。

執行結構描述轉換

建立Project後,執行結構轉換並檢視Project中的結果。

擷取並轉換結構

  1. 選擇 遷移 以開始擷取與轉換。
  2. 監控萃取和轉換進度。
  3. 當專案顯示 [結構描述轉換已完成] 時,請選取 [檢閱轉換摘要]。

HTML 報告會在轉換完成時自動開啟。 選取 [轉換摘要] 上的 [轉換報告] 以重新開啟它。 分別檢視發現、提取及轉換總額;它們描述不同的階段。

檢視已轉換的物件

使用 Conversion 物件總管 比較可用定義,並閱讀已轉換與未轉換物件的備註。 Ask 和 Fix 提供 Copilot 協助;Resolve 會更新已檢視物件的記錄狀態,而 Refresh 則會更新報告。 分別檢視編譯結果與部署納入情況。

關於相依物件修正、套件成員、手動編譯及完整範例,請參考 Conversion 物件總管。

準備部署

在 轉換摘要中,選取 設定說明 以開啟產生的部署說明並顯示設定目錄所在位置。 檢閱 postgres_ddl 中的套件與工具所產生的物件檔案,執行僅驗證檢查,然後對 適用於 PostgreSQL 的 Azure 資料庫 彈性伺服器或 Azure HorizonDB 上您選擇的目標資料庫執行產生的部署指令碼。 Setup 會讀取這些檔案最新儲存的內容用於部署,包括手動編輯和 Fix 更正。 手動新增的 postgres_ddl 檔案會被安裝程式忽略。 產生設定檔案並不會部署結構描述。

在正式使用前,請審查部署報告並獨立驗證資料與應用程式行為。 如需必要條件、資料庫模式和命令,請參閱使用設定體驗部署已轉換的結構描述。

轉換應用程式程式碼

將 Oracle 專用的應用程式程式碼(SQL 腳本、儲存程序、載入控制檔、shell 腳本或 Java 檔案)轉換為與 PostgreSQL 相容的對應內容。 對於合併轉換工作流程,請將已檢視的架構輸出作為上下文。 應用程式轉換是預覽功能。

選擇轉換方法

此擴充功能提供兩種應用程式代碼轉換路徑:

  • 完整應用程式現代化:如果您安裝了 GitHub Copilot 應用程式 現代化擴充功能,請選擇「使用 app 現代化遷移」,以繼續從結構轉換中撰寫程式碼筆記。 選擇 「檢視編碼筆記 」以在繼續前查看已產生的指引。
  • 僅資料庫選項:若只要在此擴充功能中轉換資料庫相關的應用程式程式碼,請選取 Migrate using PostgreSQL extension。

在擴充功能中轉換應用程式代碼

  1. 在 應用程式遷移 卡片上,啟動應用程式轉換工作流程。 如果出現方法選擇器,請選擇 使用 PostgreSQL 擴充功能進行遷移。
  2. 在 「轉換應用程式 」頁面,選擇「 選擇 Oracle 應用程式以轉換 」,並選擇包含 Oracle 應用程式程式碼的資料夾。
  3. 選擇 PostgreSQL 連線 及 PostgreSQL 資料庫 以取得轉換上下文。
  4. 如果資料庫清單為空, 請選擇載入資料庫 。
  5. 選擇 轉換應用程式 以開始轉換。

使用 Copilot 工具進行應用程式轉換

該擴充套件註冊了兩個 Copilot 語言模型工具以協助轉換:

  • Oracle 用戶端程式碼應用程式轉換器 (pgsql_migration_oracle_app):利用提示範本及結構轉換的程式碼指引,將 Oracle 用戶端應用程式程式碼轉換為 PostgreSQL 等效程式。 接受以下參數:

    • 應用程式程式碼庫資料夾 (必填):要轉換的程式碼位置。
    • Coding Notes Location Path (選用):結構描述轉換產生的程式碼附註路徑。
    • Postgres DB 名稱 (選填):用於轉換上下文的 PostgreSQL 資料庫名稱。
    • Postgres DB 連線 (選用):PostgreSQL 資料庫的連線名稱。
  • 顯示 Oracle 至 Postgres 遷移報告 (pgsql_migration_show_report):顯示結構轉換報告。 需要一個 路徑到報告檔案 參數。

欲了解更多使用 Copilot 工具的資訊,請參見 Copilot 整合。

比較轉換後的檔案

若要檢視目前的結構轉換輸出,請使用 Conversion 物件總管 瀏覽來源到目標的對應,包括具有多個目標定義的物件。

若要比較已轉換的應用程式檔案(.sql、.ctl.sh.load或.java),請在檔案總管中滑鼠右鍵按一下該檔案,然後選擇「比較應用程式遷移檔案對」。 檢視原始程式碼與轉換後的程式碼,並使用修正後的 PostgreSQL 架構測試應用程式。

對於採用舊版配對資料夾配置的專案,比較 DDL 遷移檔案對預期在 folder\postgres\SCHEMA_NAME\DDL-TYPE 和 folder\oracle\SCHEMA_NAME\DDL-TYPE 下有相符的路徑。 此配置並非目前 postgres_ddl 套件的導覽路徑。

管理轉換專案

請使用側邊欄的 遷移 檢視來管理您的專案:

Action Description
Open Migration Project 在儀表板中開啟現有的轉換Project。
Reveal in Explorer 在檔案總管檢視中顯示專案資料夾。
刪除 移除轉換專案。 刪除前會提示確認。
重新整理 重新載入目前工作區中的轉換專案清單。