DMS 結構描述轉換的轉換評估報告

下列範例使用 start-metadata-model-assessment 將 ExampleSchema 結構描述中所有物件轉換複雜性的評估排入佇列。

aws dms start-metadata-model-assessment \
        --migration-project-identifier "arn:aws:dms:us-east-1:111122223333:migration-project:EXAMPLEABCDEFGHIJKLMNOPQRS" \
        --selection-rules '{"rules": [{"rule-type": "selection", "rule-id": "1", "rule-name": "1", "object-locator": {"server-name": "source-server", "schema-name": "ExampleSchema"}, "rule-action": "explicit"}]}'

回應包含RequestIdentifier可識別評估請求的 。

{
    "RequestIdentifier": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111"
}

由於評估會以非同步方式執行，因此請使用 aws dms 等待metadata-model-assessed，直到評估完成再繼續。

aws dms wait metadata-model-assessed \
        --migration-project-identifier "arn:aws:dms:us-east-1:111122223333:migration-project:EXAMPLEABCDEFGHIJKLMNOPQRS"

命令每 30 秒輪詢一次，並在評估達到結束狀態時傳回 。如果評估在 360 次檢查後未完成 （約 3 小時），則會以傳回碼 255 結束。

開始評估不會每次從頭開始產生全新的報告。轉換評估報告會反映遷移專案的目前狀態，因此其中包含您目前評估或轉換的任何動作項目和生成式 AI 候選項目。如需詳細資訊，請參閱了解轉換評估報告指標。

PDF 報告

CSV 匯出

S3 儲存貯體和檔案名稱

DMS 結構描述轉換存放匯出報告的 Amazon S3 儲存貯體是您建立遷移專案時在 S3 儲存貯體存取設定下指定的儲存貯體。

檔案存放在符合您遷移專案名稱的資料夾下。從 匯出時 AWS 管理主控台，檔案會使用來源引擎、目標引擎和 UTC 時間戳記來命名：project-name/SOURCE_ENGINE_TARGET_ENGINE_YYYY-MM-DDTHH-MM-SS.sssZ，例如 ora-pg-demo/ORACLE_POSTGRESQL_2026-07-01T09-00-47.846Z.pdf。

CSV 封存包含至少三個以兩層目錄路徑組織的檔案。最上層目錄是與來源資料提供者 （主機名稱或 IP 地址） 中所設定的來源伺服器名稱。子目錄和檔案名稱使用目標資料庫主機名稱：

下列範例使用 export-metadata-model-assessment，將遷移專案的轉換評估報告匯出為 PDF 檔案和 CSV 封存到您的 Amazon S3 儲存貯體。

aws dms export-metadata-model-assessment \
        --migration-project-identifier "arn:aws:dms:us-east-1:111122223333:migration-project:EXAMPLEABCDEFGHIJKLMNOPQRS" \
        --selection-rules '{"rules":[{"rule-type":"selection","rule-id":"1","rule-name":"1","rule-action":"explicit","object-locator":{"server-name":"source-server","schema-name":"ExampleSchema"}}]}' \
        --assessment-report-types pdf csv

回應包含每個報告檔案的 Amazon S3 物件金鑰和下載 URL。

當您未指定 時--file-name，檔案會存放在符合您遷移專案名稱的資料夾下，並使用時間戳記做為檔案名稱： project-name/YYYY-MM-DD-HH-MM-SS.pdf和 project-name/YYYY-MM-DD-HH-MM-SS.zip - 例如 sqlserver-pg-pma/2026-07-15-10-08-12.zip。指定 --file-name 以覆寫該資料夾中的時間戳記字首。

{
    "PdfReport": {
        "S3ObjectKey": "project-name/YYYY-MM-DD-HH-MM-SS.pdf",
        "ObjectURL": "https://amzn-s3-demo-bucket.s3.amazonaws.com/project-name/YYYY-MM-DD-HH-MM-SS.pdf"
    },
    "CsvReport": {
        "S3ObjectKey": "project-name/YYYY-MM-DD-HH-MM-SS.zip",
        "ObjectURL": "https://amzn-s3-demo-bucket.s3.amazonaws.com/project-name/YYYY-MM-DD-HH-MM-SS.zip"
    }
}

在您執行評估或轉換之後，DMS 結構描述轉換會在下列索引標籤中新增資訊：

摘要索引標籤

摘要索引標籤會顯示轉換評估報告中的摘要資訊。它顯示 DMS 結構描述轉換可以自動轉換資料庫儲存物件和資料庫程式碼物件的資料庫物件數量。

DMS 結構描述轉換會自動轉換許多資料庫物件，並識別需要手動動作才能完成轉換為目標資料庫引擎的物件。摘要索引標籤提供在目標資料庫執行個體中建立資料庫物件的必要工作量估計值，這些物件等同於來源中的資料庫物件。

若要查看資料庫儲存體物件 (例如資料表、序列、限制、資料類型等) 的轉換摘要，請選擇資料庫儲存物件。

若要查看資料庫程式碼物件 (例如程序、函數、檢視、觸發程序等) 的轉換摘要，請選擇資料庫程式碼物件。

若要變更評估報告的範圍，請在來源資料庫樹狀結構中選取所需的節點。DMS 結構描述轉換會更新評估報告摘要，以符合所選範圍。

Action items (動作項目) 索引標籤

動作項目索引標籤包含 DMS 結構描述轉換無法自動轉換為與目標資料庫引擎相容格式的資料庫物件的動作項目清單。對於每個動作項目，DMS 結構描述轉換都會提供問題的說明和建議的動作。DMS 結構描述轉換會將類似的動作項目分組，並顯示出現次數。

若要檢視相關資料庫物件的程式碼，請選取清單中的動作項目。

生成式 AI

DMS 結構描述轉換與生成式 AI 透過提供建議來簡化資料庫遷移程序，協助您轉換先前未轉換且通常需要複雜手動轉換的程式碼物件。目前，此功能適用於 Oracle、SQL Server、SAP ASE (Sybase ASE)、適用於 LUW 的 IBM Db2 和適用於 z/OS 的 IBM Db2 作為來源資料庫，並轉換為 PostgreSQL 或 Aurora PostgreSQL。

評估報告顯示哪些資料庫程式碼物件是使用生成式 AI 轉換的候選項目。您可以將此報告匯出至 PDF，以取得每個動作項目五個物件的簡短清單。您可以將報告匯出至 CSV 檔案，以查看候選項目的完整清單。

當您啟用使用生成式 AI 轉換結構描述並執行轉換時，更新的評估報告會將每個資料庫物件標記為對應的動作項目，包括使用生成式 AI 成功轉換的物件，以及生成式 AI 無法轉換的物件，讓您輕鬆識別和追蹤 AI 輔助轉換的結果。

若要快速找出由生成式 AI 轉換的物件：

此篩選方法可讓您有效率地檢視使用此功能成功轉換的所有資料庫物件。如需使用生成式 AI 轉換資料庫物件的詳細資訊，請參閱 生成式 AI 轉換的範圍。

PDF 報告包含以下四個章節，依此順序排列：

若要將報告匯出為 PDF，請參閱 儲存評估報告。

當您將評估報告匯出至 CSV 時，DMS 結構描述轉換會建立包含至少三個 CSV 檔案的封存。封存使用兩層目錄結構：最上層目錄是完全與來源資料提供者 （主機名稱或 IP 地址） 中所設定的來源伺服器名稱，而子目錄和檔案名稱使用目標資料庫主機名稱。

動作項目檔案 (target-host.csv)

主要 CSV 檔案 （無尾碼） 包含每個動作項目出現的一列。它包含下列資料欄：

動作項目摘要檔案 (target-host_Action_Items_Summary.csv)

每個動作項目類型包含一個資料列，其中包含下列資料欄：

摘要檔案 (target-host_Summary.csv)

每個資料庫物件類型包含一個資料列，其中包含下列資料欄：

若要將報告匯出為 CSV，請參閱 儲存評估報告。

Stub 物件檔案 (target-host_Stub_Objects.csv)

只有在遷移專案設定中啟用將不支援的內建物件轉換為 stub 物件時，才會出現此檔案。它包含針對不支援的內建產生的每個 stub 物件一列，其中包含下列資料欄：