生成报告 (Db2ToSQL)

使用命令执行的某些活动的报表在对象树级别的SQL Server 迁移助手(SSMA)控制台中生成。

生成报告

使用以下过程生成报告:

  1. write-summary-report-to指定参数。 相关报告会以文件名(如果指定)存储或在指定文件夹中存储。 文件名是系统预定义的,如下表所述,其中 <n> 唯一的文件编号随同一命令的每个执行一个数字而递增。

    报告与命令相关,如下所示:

    槽号 命令 报表标题
    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-report命令convert-schemamigrate-dataconvert-sql-statement和命令。

  3. 使用“错误报告”设置指示错误报告中所需信息的详细程度:

    槽号 命令和参数 输出说明
    1 report-errors="false" 没有有关错误、警告或信息消息的详细信息。
    2 report-errors="true" 详细的错误、警告或信息消息。

    注意

    错误报告设置适用于generate-assessment-report命令convert-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