生成报告 (DB2ToSQL)

  • 项目

使用命令执行的某些活动的报告可在 SSMA 控制台中的对象树级别生成。

使用以下过程生成报告：

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

    报告与相应命令包括：

    Sl. 编号 命令 报告标题
    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 报告。

    有关输出报告的命令选项（上文的 Sl. 第 2-4 项），请参阅“执行 SSMA 控制台 (DB2ToSQL)”部分。

  2. 使用“报告详细程度”设置指示输出报告中所需的详细程度：

    Sl. 编号 命令和参数 输出说明
    1 verbose="false" 生成该活动的汇总报告。
    2 verbose=“true” 为每个活动生成汇总和详细状态报告。

    注意

    上面指定的“报告详细程度”设置适用于 generate-assessment-report、convert-schema、migrate-data、convert-sql-statement 命令。

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

    Sl. 编号 命令和参数 输出说明
    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-erors="<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 参数，该参数指定同步操作的错误报告位置。 然后，会在指定位置创建一个名为 SourceDBRefreshReport<n>.XML 的文件，其中 <n> 是唯一文件编号，每次执行相同的命令时会递增一个数字。

注意：如果提供了文件夹路径，则“report-errors-to”参数将成为命令“synchronize-target”的可选属性。

<!-- Example: Synchronize target entire Database with all attributes-->  
  
<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”的可选属性。

<!-- Example: Refresh entire Schema (with all attributes)-->  
  
<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

另请参阅

执行 SSMA 控制台