生成报告 (AccessToSQL)

使用命令执行的某些活动的报告可在 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 synchronize-target TargetSynchronizationReport<n>.XML
    5 refresh-from-database SourceDBRefreshReport<n>.XML

    重要

    输出报告不同于评估报告。 前者是有关所执行命令性能的报告,而后者是针对编程使用情况的 XML 报告。

    有关输出报告的命令选项(上文的序列号 2-4),请参阅执行 SSMA 控制台 (AccessToSQL) 部分。

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

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

    注意

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

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

    Sl. 号 命令和参数 输出说明
    1 report-errors=“false” 没有有关错误/警告/信息消息的详细信息。
    2 report-errors=“true” 详细的错误/警告/信息消息。

    注意

    上面指定的“错误报告”设置适用于 generate-assessment-report、convert-schema、migrate-data 命令。

示例:

<generate-assessment-report  
  
    object-name="testschema"  
  
    object-type="Schemas"  
  
    verbose="yes"  
  
    report-errors="yes"  
  
    write-summary-report-to="$AssessmentFolder$\Report1.xml"  
  
    assessment-report-folder="$AssessmentFolder$\assessment_report"  
  
    assessment-report-overwrite="true"  
  
/>  

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="$TargetDB$.dbo"  
  
    on-error="fail-script"  
  
    report-errors-to="$SynchronizationReports$"  
  
/>  

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="$SourceDatabaseStandard$"  
  
    object-type ="Databases"  
  
    on-error="fail-script"  
  
    report-errors-to="$RefreshDBFolder$\RefreshReport.xml"  
  
/>  

object-name: 指定考虑刷新的对象(也可以具有单个对象名称或组对象名称)。

on-error:指定是将刷新错误指定为警告还是错误。 可用于 on-error 的选项:

  • report-total-as-warning

  • report-each-as-warning

  • fail-script

另请参阅

执行 SSMA 控制台 (Access)