生成报告 (OracleToSQL)

使用命令执行的某些活动的报告可在 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 控制台 (OracleToSQL) 部分。

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

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

    注意

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

  3. 使用“错误报告”设置,指示你在错误报告中需要的详细程度:

    序列 号 命令和参数 输出说明
    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 参数,该参数指定同步操作的错误报告位置。 随后,会在指定的位置创建一个名为 TargetSynchronizationReport<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:指定是将同步错误指定为警告还是错误。 错误时的可用选项:

  • 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:指定是将刷新错误指定为警告还是错误。 错误时的可用选项:

  • report-total-as-warning

  • report-each-as-warning

  • fail-script

另请参阅

执行 SSMA 控制台 (Oracle)