本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# DMS 結構描述轉換的轉換評估報告
<a name="assessment-reports"></a>

DMS 結構描述轉換的一個重要部分是其產生的報告，可幫助您轉換結構描述。此*轉換評估報告*會分析來源結構描述中的資料庫物件，並識別 DMS 結構描述轉換可以自動轉換的物件，以及哪些物件需要手動動作。您可以在 AWS DMS 主控台中檢視報告，或將副本儲存為 PDF 或逗號分隔值 (CSV) 檔案。

轉換評估報告包含下列項目：
+ 執行摘要
+ 轉換需要手動動作之資料庫物件的建議

當您有 DMS 結構描述轉換無法自動轉換的資料庫物件時，報告會提供預估值，顯示為目標資料庫執行個體寫入對等程式碼所需的工作量。

**Topics**
+ [使用 DMS 結構描述轉換執行轉換評估報告的評估](#assessment-reports-create)
+ [儲存 DMS 結構描述轉換的轉換評估報告](#assessment-reports-save)
+ [檢視 DMS 結構描述轉換的轉換評估報告](#assessment-reports-view)
+ [了解轉換評估報告指標](assessment-reports-understanding.md)
+ [使用轉換評估報告進行遷移規劃](assessment-reports-planning.md)

## 使用 DMS 結構描述轉換執行轉換評估報告的評估
<a name="assessment-reports-create"></a>

建立遷移專案之後，請使用下列其中一種方法來執行轉換複雜性的評估。

------
#### [ AWS Management Console ]

**執行評估並產生轉換評估報告**

1. 登入 AWS 管理主控台 並在 https：//[https://console.aws.amazon.com/dms/v2/](https://console.aws.amazon.com/dms/v2/) 開啟 AWS DMS 主控台。

1. 選擇**遷移專案**。**遷移專案**頁面隨即開啟。

1. 選擇遷移專案，然後選擇**結構描述轉換**。

1. 選擇**啟動架構轉換**。**結構描述轉換**頁面隨即開啟。

1. 在來源資料庫窗格中，選取您要評估的節點。**評估**動作可在**資料庫**節點、個別資料庫節點和 **dbo** 等結構描述節點上使用。它不適用於個別物件節點，例如資料表或程序。

1. 在來源資料庫窗格中選取至少一個父節點。只有在選取父節點時，才能使用**動作**功能表。

1. 開啟**動作**功能表，然後選擇**評估**。出現確認對話方塊。

1. 在對話方塊中選擇**評估**以確認選擇。

------
#### [ AWS CLI ]

下列範例使用 [start-metadata-model-assessment](https://docs.aws.amazon.com/cli/latest/reference/dms/start-metadata-model-assessment.html) 將 {{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"}]}'
```

**注意**  
`--selection-rules` 參數採用 JSON 字串，指定要包含在評估中的資料庫物件。如需完整的選取規則 JSON 結構，請參閱 [DMS 結構描述轉換中的選取規則](sc-selection-rules.md)。

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

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

由於評估會以非同步方式執行，因此請使用 [aws dms 等待metadata-model-assessed](https://docs.aws.amazon.com/cli/latest/reference/dms/wait/metadata-model-assessed.html)，直到評估完成再繼續。

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

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

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

------

## 儲存 DMS 結構描述轉換的轉換評估報告
<a name="assessment-reports-save"></a>

執行評估或轉換之後，您可以將轉換評估報告的副本儲存為 PDF 或逗號分隔值 (CSV) 檔案。

------
#### [ AWS Management Console ]

**將轉換評估報告儲存為 PDF 檔案**

1. 選擇**匯出**，然後選擇 **PDF**。檢閱對話方塊，然後選擇**匯出為 PDF**。

1. DMS 結構描述轉換會將 PDF 檔案存放在您在遷移專案的 Amazon S3 **S3 儲存貯體**中。

1. 在 Amazon S3 儲存貯體中開啟評估報告檔案。

**將轉換評估報告儲存為 CSV 檔案**

1. 選擇**匯出**，然後選擇 **CSV**。檢閱對話方塊，然後選擇**匯出為 CSV 格式**。

1. DMS 結構描述轉換會將包含 CSV 檔案的 ZIP 封存存放在您在遷移專案的 Amazon S3 **S3 ** 儲存貯體中。

1. 從 Amazon S3 儲存貯體下載並擷取 ZIP 封存，以存取 CSV 檔案。

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

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

CSV 封存包含至少三個以兩層目錄路徑組織的檔案。最上層目錄是與**來源資料提供者 （主機名稱或 IP 地址） 中所設定的來源伺服器名稱**。子目錄和檔案名稱使用**目標資料庫主機名稱**：
+ `{{source-server}}/{{target-host}}/{{target-host}}.csv` — 每個出現的動作項目一列。
+ `{{source-server}}/{{target-host}}/{{target-host}}_Action_Items_Summary.csv` — 每個動作項目類型一列，具有工作量值。
+ `{{source-server}}/{{target-host}}/{{target-host}}_Summary.csv` — 每個物件類型一列，具有複雜性計數。
+ `{{source-server}}/{{target-host}}/{{target-host}}_Stub_Objects.csv` — 針對不支援的內建產生每個 stub 物件一列。只有在遷移專案設定中啟用將**不支援的內建物件轉換為 stub 物件**時，才會出現此檔案。

------
#### [ AWS CLI ]

下列範例使用 [export-metadata-model-assessment](https://docs.aws.amazon.com/cli/latest/reference/dms/export-metadata-model-assessment.html)，將遷移專案的轉換評估報告匯出為 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
```

**注意**  
`--selection-rules` 參數採用 JSON 字串，指定要包含在報告中的資料庫物件。如需完整的選取規則 JSON 結構，請參閱 [DMS 結構描述轉換中的選取規則](sc-selection-rules.md)。

回應包含每個報告檔案的 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 結構描述轉換使用生成式 AI 轉換的物件。如需執行轉換的資訊，請參閱 [轉換資料庫結構描述：step-by-step指南](schema-conversion-convert.md)。

## 檢視 DMS 結構描述轉換的轉換評估報告
<a name="assessment-reports-view"></a>

若要檢視轉換評估報告，請使用下列其中一種方法。

**重要**  
轉換評估報告僅涵蓋最近評估或轉換操作範圍內包含的資料庫物件。執行**評估**或**轉換**時未選取的物件不會出現在報告中，即使它們存在於您的來源資料庫中。  
每個新的評估或轉換操作都會覆寫先前的報告。**摘要**和**動作項目**索引標籤一律只會反映最新的操作。如果您需要保留目前報告的結果，請在執行新的評估或轉換之前將其匯出為 PDF 或 CSV 檔案。如需匯出指示，請參閱 [儲存評估報告](#assessment-reports-save)。

------
#### [ AWS Management Console ]

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

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

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

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

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

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

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

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

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 轉換的物件：

1. 導覽至**動作項目**索引標籤。

1. 在右上角，找到下拉式選單。

1. 從選項中選取 **AI 產生**。

此篩選方法可讓您有效率地檢視使用此功能成功轉換的所有資料庫物件。如需使用生成式 AI 轉換資料庫物件的詳細資訊，請參閱 [生成式 AI 轉換的範圍](schema-conversion-convert.databaseobjects.md#schema-conversion-convert.databaseobjects.genai)。

------
#### [ PDF report ]

PDF 報告包含以下四個章節，依此順序排列：
+ **執行摘要** — 遷移複雜性的概觀。顯示 DMS 結構描述轉換可自動轉換的資料庫物件數量，以及需要手動動作、依物件類型 （資料表、檢視、程序、觸發程序等） 和複雜度類別 （自動轉換、簡單動作、中複雜度動作和複雜動作） 細分的數目。如需這些類別的詳細資訊，請參閱 [複雜性類別](assessment-reports-understanding.md#assessment-reports-understanding-complexity)。
+ **具有轉換動作的資料庫物件** — 依物件類型整理的特定資料庫物件需要手動動作的明細。每個項目會依名稱識別物件，並列出其動作項目代碼。
+ **使用生成式 AI 轉換的候選者** — DMS 結構描述轉換識別為使用生成式 AI 自動轉換候選者的資料庫物件。PDF 列出每個動作項目類型最多五個候選物件。若要查看候選項目的完整清單，請將報告匯出為 CSV。
+ **遷移的詳細建議** — 需要手動動作的每個資料庫物件分析。對於每個物件，本章會顯示動作項目代碼 （請參閱[動作項目代碼](assessment-reports-understanding.md#assessment-reports-understanding-codes))、與目標資料庫引擎的特定不相容描述，以及建議的手動轉換動作。與 中的**動作項目**索引標籤不同 AWS 管理主控台，這些索引標籤會依類型在所有物件中分組動作項目，本章會個別列出每個受影響的物件。

若要將報告匯出為 PDF，請參閱 [儲存評估報告](#assessment-reports-save)。

------
#### [ CSV report ]

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

主要 CSV 檔案 （無尾碼） 包含每個動作項目出現的一列。它包含下列資料欄：
+ **類別** — 動作項目套用的資料庫物件類型，例如 `procedure`或 `view-constraint`。
+ **發生 —** 動作項目影響的特定資料庫物件執行個體的完整路徑，例如 `Schemas.{{schema_name}}.Procedures.{{procedure_name}}`。
+ **動作項目** — 識別轉換問題類型的數值動作項目代碼。如需詳細資訊，請參閱[動作項目代碼](assessment-reports-understanding.md#assessment-reports-understanding-codes)。
+ **主旨** — 動作項目參考的特定資料庫物件名稱或程式碼元素，例如未解析的識別符。當動作項目未參考特定物件名稱時，此欄位為空白。
+ **群組** — 該動作項目程式碼每次出現時所共用之問題類型的一般描述。DMS 結構描述轉換會使用此值將相關事件分組在一起。
+ **描述** — 此發生的特定不相容的詳細說明。
+ **文件參考** — 解決不相容的相關文件連結。
+ **建議動作** — 解決不相容的建議手動轉換步驟。
+ **已篩選** — 指出動作項目是否已從報告檢視中篩選出來。
+ **預估複雜性** — 指派給此事件的複雜性類別：自動轉換、簡單動作、中複雜度動作或複雜動作。
+ **行** — 來源物件程式碼中發生不相容的行號。
+ **位置** — 發生不相容的行上的字元位置。
+ **來源** — 來源資料庫引擎。
+ **Target** — 目標資料庫引擎。
+ **伺服器 IP 地址和連接埠** — 來源資料庫伺服器的主機和連接埠。
+ **資料庫名稱** — 來源資料庫的名稱。
+ **結構描述名稱** — 包含受影響物件的來源結構描述名稱。
+ **AI/ML 建議** — 啟用生成式 AI 轉換並產生此發生結果時，轉換此物件的生成式 AI 建議。{{}}

每個動作項目類型包含一個資料列，其中包含下列資料欄：
+ **結構描述** — 包含受影響物件的來源結構描述名稱。
+ **動作項目** — 識別轉換問題類型的數值動作項目代碼。如需詳細資訊，請參閱[動作項目代碼](assessment-reports-understanding.md#assessment-reports-understanding-codes)。
+ **出現次數** — 受此動作項目類型影響的資料庫物件總數。
+ **學習曲線工作** — 為此動作項目類型設計轉換方法所需的一次性工作。無論發生次數為何，每個動作項目類型都會產生一次此成本。值使用從低 （最不費力） 到高 （最費力） 的加權比例。
+ **轉換發生次數 —** 按照設計轉換方法解決此動作項目類型每個個別發生次數所需的工作量。值使用與學習曲線工作相同的加權比例。
+ **動作項目描述** — 此動作項目類型所代表不相容的描述。
+ **建議的動作** — 解決此動作項目類型的建議手動轉換步驟。{{}}

每個資料庫物件類型包含一個資料列，其中包含下列資料欄：
+ **類別** — 資料列摘要的資料庫物件類型，例如 `TABLE`、`VIEW`、`PROCEDURE`、`TRIGGER`、`INDEX`、`CONSTRAINT`、 `SEQUENCE`或 `FUNCTION`。檔案也包含`Category`值為 `Storage_objects_count`、 `Code_objects_count`或 的彙總指標資料列`SQL_syntax_elements_number`。如需這些彙總值的詳細資訊，請參閱 [轉換統計資料和 SQL 指標](assessment-reports-understanding.md#assessment-reports-understanding-statistics)。
+ **物件數量** — 評估範圍內此類型的資料庫物件總數。
+ **物件會自動轉換** — DMS 結構描述轉換無需任何手動動作即可轉換的物件數量。
+ **具有簡單動作的物件** — 需要少量手動轉換的物件數量。
+ **具有中等複雜度動作的物件** — 需要中等程度手動嘗試轉換的物件數量。
+ **具有複雜動作的物件** — 需要大量手動嘗試轉換的物件數量。
+ **程式碼的總行**數 — 此類型所有物件的來源程式碼行總數。

若要將報告匯出為 CSV，請參閱 [儲存評估報告](#assessment-reports-save)。{{}}

只有在遷移專案設定中啟用將**不支援的內建物件轉換為 stub 物件**時，才會出現此檔案。它包含針對不支援的內建產生的每個 stub 物件一列，其中包含下列資料欄：
+ **類別** — stub 物件的類型，例如 `scalar-function`。
+ **Stub 物件名稱** — 產生之 Stub 的完整名稱，包括結構描述和簽章。
+ **出現次數** — 在轉換後的程式碼中參考此 stub 物件的次數。

------