使用命令執行的特定活動報告會在物件樹狀結構層級的 SQL Server 移轉小幫手 (SSMA) 控制台中產生。
產生報告
使用下列程序產生報表:
指定
write-summary-report-to參數。 相關報表會儲存為檔案名稱(如果有指定)或儲存在您指定的資料夾中。 檔名是系統預先定義的,如下表所述,其中<n>是唯一的檔案編號,會隨著每個執行相同命令的位數而遞增。這些報告與命令相關,如下所示:
插槽編號 命令 報表標題 1 generate-assessment-reportAssessmentReport<n>.xml2 convert-schemaSchemaConversionReport<n>.xml3 migrate-dataDataMigrationReport<n>.xml4 convert-sql-statementConvertSQLReport<n>.xml5 synchronize-targetTargetSynchronizationReport<n>.xml6 refresh-from-databaseSourceDBRefreshReport<n>.xml重要
輸出報表與評量報表不同。 前者是執行命令效能的報告,而後者則是 XML 報表,可供程式設計取用。
如需輸出報表的命令選項(上表中的插槽編號 2 - 4),請參閱 執行 SSMA 控制台 一節。
使用 [報表詳細程度] 設定,指出您在輸出報表中所需的詳細資料範圍:
插槽編號 命令和參數 輸出描述 1 verbose="false"產生活動的摘要報表。 2 verbose="true"產生每個活動的摘要和詳細狀態報表。 注意
報告詳細程度設定會套用至
generate-assessment-report、convert-schema、migrate-data和convert-sql-statement命令。使用 [錯誤報表] 設定,指出您在錯誤報表中所需的詳細資料範圍:
插槽編號 命令和參數 輸出描述 1 report-errors="false"沒有錯誤、警告或資訊訊息的詳細數據。 2 report-errors="true"詳細的錯誤、警告或資訊訊息。 注意
錯誤報告設定會套用至
generate-assessment-report、convert-schema、migrate-data和convert-sql-statement命令。
範例
<generate-assessment-report
object-name="<object-name>"
object-type="<object-type>"
verbose="<true/false>"
report-errors="<true/false>"
write-summary-report-to="<file-name/folder-name>"
assessment-report-folder="<folder-name>"
assessment-report-overwrite="<true/false>"/>
報表指令
同步目標
命令 synchronize-target 具有 report-errors-to 參數,指定同步處理作業的錯誤報告位置。 然後,會在指定位置建立一個名稱為 TargetSynchronizationReport<n>.xml 的檔案,其中 <n> 是唯一的檔案編號,隨著每次執行相同命令而增加一位數字。
注意
如果指定資料夾路徑,則 report-errors-to 參數會變成命令 synchronize-target的選擇性屬性。
下列範例會將整個目標資料庫與所有屬性同步處理。
<synchronize-target
object-name="<object-name>"
on-error="report-total-as-warning/report-each-as-warning/fail-script"
report-errors-to="<file-name/folder-name>"/>
object-name指定要進行同步處理的物件。 它也可以有個別的物件名稱或群組物件名稱。on-error指定是否要將同步處理錯誤指定為警告或錯誤。 可以選擇的選項on-error:report-total-as-warningreport-each-as-warningfail-script
從資料庫更新
命令 refresh-from-database 具有 report-errors-to 參數,指定重新整理作業的錯誤報告位置。 然後,在指定位置建立名為 SourceDBRefreshReport<n>.xml 的檔案,其中 <n> 是唯一的檔案編號,會隨著每次執行相同命令而增加一位數。
如果指定資料夾路徑,則 report-errors-to 參數會變成命令 synchronize-target的選擇性屬性。
下列範例會使用所有屬性重新整理整個架構。
<refresh-from-database
object-name="<object-name>"
object-type ="<object-type>"
on-error="report-total-as-warning/report-each-as-warning/fail-script"
report-errors-to="<file-name/folder-name>"/>
object-name指定考慮重新整理的物件。 它也可以有個別的物件名稱或群組物件名稱。on-error指定是否要將重新整理錯誤指定為警告或錯誤。on-error的可用選項:report-total-as-warningreport-each-as-warningfail-script