共用方式為


產生報告 (Db2ToSQL)

使用命令執行的特定活動報告會在物件樹狀結構層級的 SQL Server 移轉小幫手 (SSMA) 控制台中產生。

產生報告

使用下列程序產生報表:

  1. write-summary-report-to指定 參數。 在您指定的資料夾中,相關報表會儲存為檔案名稱 (如果指定)。 檔名是系統預先定義的,如下表所述,其中 <n> 是唯一的檔案編號,會隨著每個執行相同命令的位數而遞增。

    這些報告與命令相關,如下所示:

    插槽編號 Command 報表標題
    1 generate-assessment-report AssessmentReport<n>.xml
    2 convert-schema SchemaConversionReport<n>.xml
    3 migrate-data DataMigrationReport<n>.xml
    4 convert-sql-statement ConvertSQLReport<n>.xml
    5 synchronize-target TargetSynchronizationReport<n>.xml
    6 refresh-from-database SourceDBRefreshReport<n>.xml

    重要

    輸出報表與評量報表不同。 前者是執行命令效能的報告,而後者則是 XML 報表,可供程式設計取用。

    如需輸出報表的命令選項(上表中的插槽編號 2 - 4),請參閱 執行 SSMA 控制台 一節。

  2. 使用 [報表詳細程度] 設定,指出您在輸出報表中所需的詳細資料範圍:

    插槽編號 命令和參數 輸出描述
    1 verbose="false" 產生活動的摘要報表。
    2 verbose="true" 產生每個活動的摘要和詳細狀態報表。

    注意

    報表詳細資訊設定會套用至 generate-assessment-reportconvert-schemamigrate-dataconvert-sql-statement 命令。

  3. 使用 [錯誤報表] 設定,指出您在錯誤報表中所需的詳細資料範圍:

    插槽編號 命令和參數 輸出描述
    1 report-errors="false" 沒有錯誤、警告或資訊訊息的詳細數據。
    2 report-errors="true" 詳細的錯誤、警告或資訊訊息。

    注意

    錯誤報告設定會套用至 generate-assessment-reportconvert-schemamigrate-dataconvert-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

命令 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-warning
    • report-each-as-warning
    • fail-script

refresh-from-database

命令 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-warning
    • report-each-as-warning
    • fail-script