適用於 Oracle 的資料庫移轉評定延伸模組

注意

此延伸項目將於 2024 年 12 月 15 日淘汰。 我們將停止針對任何發生的問題支援此工具，而且不會發出任何錯誤修正或進一步更新。

Azure Data Studio 中的 Oracle Database Migration Assessment 延伸模組可協助您評估 Oracle 工作負載，以移轉至 Azure SQL 和適用於 PostgreSQL 的 Azure 資料庫。 延伸模組會識別適當的 Azure SQL 或 PostgreSQL 目標，並提供適當調整大小的建議，以及移轉的複雜度。

必要條件

• Azure Data Studio 1.39 版或更新版本。

• 執行版本 11g 或更新版本的 Oracle 資料庫。

• Oracle 使用者應該已指派 CONNECT 和 SELECT ANY DICTIONARY 權限。

安裝 Azure Data Studio 延伸模組

請遵循這些步驟，在 Azure Data Studio 中安裝適用於 Oracle 的 Database Migration Assessment 延伸模組。

1. 在 Azure Data Studio 中開啟延伸模組管理員。 您可以選取延伸模組圖示，或在 [檢視] 功能表中選取 [延伸模組]。

2. 在搜尋列中輸入 [Oracle]。

3. 選取 [適用於 Oracle 的 Database Migration Assessment] 延伸模組，並檢視其詳細資料。

4. 選取 [安裝]。

   

進行延伸模組設定

安裝延伸模組之後，您可以進行數個延伸模組設定。

1. 移至延伸模組，然後選取 [適用於 Oracle 的 Database Migration Assessment]、選取 [管理設定] 圖示，然後選取 [延伸模組設定]。

   

2. 在 [延伸模組設定] 下，編輯任何延伸模組設定以符合環境的需求。

   

   注意

   若要執行 Oracle 至 PostgreSQL 程式碼評量，Oracle 用戶端主路徑和 Ora2Pg 安裝路徑是必要參數。

執行評量

評量延伸模組安裝之後，下一個步驟是連線到 Oracle 資料庫、從 Oracle 執行個體收集中繼資料資訊，並產生評量報表。

1. 移至功能表列中的連線圖示。

   

2. 在 [連線詳細資料] 中，填寫欄位。

   1. 在 [連線類型] 欄位中，選取 [Oracle]。
   2. 在 [資料來源] 欄位中，輸入 Oracle 伺服器名稱和執行個體。
      1. 您也可以提供 TNS 名稱。 (請確定已設定 ORACLE_HOME 環境變數，且 TNSNAMES.ORA 檔案位於 <ORACLE_HOME>/network/admin folder。)
      2. 針對容器資料庫，您可以使用 CDB 服務識別碼連接容器根資料庫，或使用插入式資料庫服務名稱來連線到插入式資料庫。
   3. 在 [使用者識別碼] 欄位中提供資料庫使用者名稱。
   4. 在 [密碼] 欄位中提供資料庫密碼。

   

3. 選取 [連線]。

4. 現在，新的連線會出現在 [連線詳細資料] 功能表中。

5. 以滑鼠右鍵按一下 Oracle 連線，然後選取 [管理]。

   

6. 選取 [移轉評量]。

   

7. 選取 [執行新的評量]。

   

8. 提供評量詳細資料。

   1. 在 [評量名稱] 欄位中，輸入標題，例如 demo1。
   2. 輸入 [評量設定]。

      1. 在 [目標平台] 欄位中輸入目的地移轉資料庫。 目前，其支援 Azure SQL 和 PostgreSQL 做為目標。

         注意

         PostgreSQL 目標處於預覽狀態。 此目標選項將會中止。 您應匯出任何先前的評定。

      2. 在 [效能資料收集] 區段中，選取 [在 Oracle 資料庫 (連線) 上執行效能資料收集] 或 [新增 AWR 報表]。

         如果您在尖峰或實際負載期間執行此工具，建議使用連線選項。 否則，請提供過去針對效能和調整大小建議所產生的 AWR 報表。

         注意

         未針對插入式資料庫啟用 AWR 報告評定選項。

      3. 在 [比例因素] 欄位中輸入乘數值。

         • 如果建議的 SKU 需要考慮其他尖峰負載，比例因素乘數應該大於 1。 例如，高載負載、季節性使用量和未來容量規劃。 移轉部分 Oracle 結構描述工作負載時，乘數應該小於 1。

      4. 在 [百分位數使用率] 欄位中，輸入調整 Azure 目標的百分位數值。

         • 要針對調整 Azure 目標大小進行考量的效能範例百分位數值。

   

9. 評定類型有兩種：

   • 工作負載評量。 在此評量中，Oracle 評量模組會執行結構描述物件的輕量型探索，並將移轉至各種類別的結構描述複雜度分類，並針對轉換時數提供高階估計值。 此預先評定有助於找出移轉至目標平台的可行性。

   • 程式碼評量。 程式碼評量會執行 Oracle 結構描述物件的深入評量，然後以細微層級的「就緒」、「需要檢閱」和「尚未就緒」物件類型，以及具有較高正確性的關聯轉換時數，建議程式碼物件的整體整備程度。

     注意

     延伸模組會使用開放原始碼 Ora2Pg 結構描述轉換器進行程式碼評量。

     如果 Oracle 用戶端和/或 Ora2Pg 未安裝在與 Azure Data Studio 相同的電腦上，請進行手動安裝，或使用來自 GitHub 的 Ora2Pg 安裝指令碼。

     如果已安裝 Oracle 用戶端和 Ora2Pg，請確定已在延伸模組設定中更新 Oracle 用戶端主路徑和 Ora2Pg 安裝路徑。

     • 當您選取 SQL 案例的程式碼評估時，請選取想要存取的結構描述，以便進行 Oracle 到 SQL 的轉換和移轉。 根據預設，系統會選取所有符合資格的結構描述來進行評定。

10. 選擇 [執行驗證] 以執行與安全性權限、組態設定等相關的必要條件和各種驗證規則。如果驗證失敗，必須先修正錯誤才能繼續下一步。

11. 驗證成功時，可以選取 [執行評定]。

12. 現在，您會在「最後五個評量」一節中看到新的評量。

    

13. 選取評量連結以檢視評量詳細資料頁面。 您可以檢視最新的評量狀態。

    

14. 選取 [重新整理]，或等到評量完成為止。 根據預設，評量狀態頁面會每隔 15 秒重新整理一次。 狀態會顯示四種狀態之一：成功、失敗、進行中或已取消。

檢視評量

評量完成後，會針對每個 Azure SQL 目標產生使用卡片的合併輸出：Azure 虛擬機器上的 SQL Server、Azure SQL Database 和 Azure SQL 受控執行個體或適用於 PostgreSQL 的 Azure 資料庫 - 彈性伺服器。

每張卡片有多個區段。 卡片會顯示移轉至目標的整體可行性。 您可以在各種移轉複雜度類別下向下鑽研各種工作負載：

• 功能相容性區段提供功能評量檢閱結果。
• SKU 建議會提供適當的目標大小調整。
• 程式碼評量提供資料庫物件的程式碼複雜度。

當您選取 [檢視報表詳細資料] 時，其會先顯示評量摘要。

如果選取的目標是 [適用於 Azure PostgreSQL 的資料庫]，則將會根據評量類型選取項目顯示 [資料庫詳細資料] 索引標籤或 [程式碼評量] 索引標籤。

下列 [資料庫詳細資料] 索引標籤會提供每個結構描述的明細。 其會顯示探索到的結構描述清單、移轉可行性，以及以小時為單位轉換結構描述的估計時間。

這項估計是以適用於物件計數、程式碼行、啟用功能和資料庫大小的統計模型為基礎。 如需更精確的程式碼轉換估算，請使用程式碼評定。

注意

下列系統或 Oracle 內建結構描述會從工作負載評量中排除：

APEX、APPQOSSYS、AUDSYS、CSMIG、 CTXSYSDBMS_PRIVILEGE_CAPTUREDBSFWUSERDBSNMPDIPDMSYSDVFDVSYSEXFSYSFLOW_GSMADMIN_INTERNALLBACSYSMDDATAMDSYSMGDSYSMGMT_VIEWMTMSYSODMODM_MTROJVMSYSOLAPSYSORACLE_OCMORDDATAORDPLUGINSORDSYSOSE$HTTP$ADMINOUTLNOWBSYSOWBSYS_AUDITPERFSTATSDESI_INFORMTN_SCHEMASPATIAL_CSW_ADMIN_USRSPATIAL_WFS_ADMIN_USRSQLTXPLAINSYSSYSMANSYSTEMTRACESRVTSMSYSWEBSYSWKPROXYWKSYSWK_PROXYWK_TESTWMSYSXDBXS$NULL

SKU 建議提供下列項目：

• 適合的 Azure 目標。

• 服務層級。

• 計量閾值可用來提供建議的 SKU。

  

SKU 建議會評估各種效能計量，例如 CPU、記憶體、IOPS、延遲和儲存體。 根據使用量和設定資料，建議工具會提供適當的目標和適當的服務層級。 SKU 建議基於容器根執行個體或插入式資料庫使用率。 略過結構描述選取範圍，不適用於 SKU 調整大小。

注意

如果 Oracle 執行個體上已啟用自動工作負載存放庫 (AWR) 功能，SKU 建議工具會使用 DBA_HIST_ 檢視來收集效能計量中繼資料。 否則，建議工具會使用伺服器設定和其他系統檢視資訊，來調整 Azure SQL 目標的大小。

程式碼相容性 (僅適用於 PostgreSQL 目標) 提供可轉換成 Azure 目標的結構描述物件摘要。 此報表提供可以自動轉換的物件細目、準備好條件，而且必須手動修復和轉換。

此報表會顯示將程式碼移轉至 Azure PostgreSQL 資料庫所需的物件和轉換工作時數總數。 圖形化影像會提供每個結構描述物件類型的細目，例如資料表、檢視和叢集。 工作分類為「就緒 - 自動轉換」、「需要檢閱」和「尚未就緒 - 需要手動轉換」。

「尚未就緒」和「需要檢閱」區段的向下鑽研會提供補救工作的清單，以及每項工作的工作時數。

功能評量提供 Oracle 至 Azure 資料目標對應的功能，以及將這些功能移轉至 Azure 目標所需的工作。

您可以選取 [下載合併報表] 或 [下載個別報表]，下載報表以供離線檢視。

您也可以取消進行中的評量、刪除評量，並將評量移至另一個目錄。

變更評量路徑

1. 移至延伸模組市集，並搜尋適用於 Oracle 的 Database Migration Assessment。
2. 選取 [管理] 圖示，然後選取 [延伸模組設定]。
3. 在 Oracle 評量：評量路徑下提供新的評量路徑。

疑難排解

記錄

延伸模組會將錯誤、警告和其他診斷記錄儲存在預設記錄目錄中：

• Windows - C:\Users\<username>.dmaoracle\logs\
• Linux - ~/.dmaoracle/logs
• macOS - /Users/<username>/.dmaoracle/logs

注意

根據預設，延伸模組會儲存最後七個記錄檔。

若要變更記錄檔目錄，請更新延伸模組設定檔中的 LogDirectory 屬性。

作業系統	路徑
Windows	C:\Users\<username>\.azuredatastudio\extensions\microsoft.azuredatastudio-dma-oracle-<VersionNumber>\bin\service\Properties\ConfigSettings\extension-settings.json
Linux	~/.azuredatastudio/extensions/microsoft.azuredatastudio-dma-oracle-<VersionNumber>/<VersionNumber>/bin/service/Properties/ConfigSettings/extension-settings.json
macOS	/Users/<username>/.azuredatastudio/extensions/microsoft.azuredatastudio-dma-oracle-<VersionNumber>/<VersionNumber>/bin/service/Properties/ConfigSettings/extension-settings.json

如需疑難排解問題的詳細資訊，請參閱針對 Oracle 延伸模組錯誤的 Database Migration Assessment 進行疑難排解。

已知問題和限制

• 提供的路徑不存在。

  原因：評量資料夾的檔案遺漏或缺少權限。

  可能的解決方案：

  • 使用者具有評量資料夾的讀取和寫入權限。
  • 如果有遺漏的檔案或資料夾，請刪除評量並產生新的評量。

• 與 Oracle 互動時遇到連線逾時例外狀況。

  原因：無法連線到 Oracle 執行個體。

  可能的解決方案：

  • 檢查防火牆規則是否封鎖 Oracle 接聽連接埠。
  • 執行 tnsping 並查看服務識別碼是否已解析。

連絡 Microsoft 以取得協助

如果您需要 Microsoft 的進一步協助，請連絡 @dmasupport。 為了加快溝通速度，您可以從預設記錄目錄附加記錄。

相關內容

• 適用於 Oracle 的延伸模組 (預覽版)
• 適用於 Azure Data Studio 的 Azure SQL 移轉延伸模組
• 資料庫結構描述轉換工具組 (DSCT)
• 擴充 Azure Data Studio 的功能