生成报告 (AccessToSQL)
使用命令执行的某些活动的报告可在 SSMA 控制台中的对象树级别生成。
使用以下过程生成报告:
指定 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) 部分。
使用“报告详细程度”设置指示输出报告中所需的详细程度:
Sl. 号 命令和参数 输出说明 1 verbose="false" 生成该活动的汇总报告。 2 verbose=“true” 为每个活动生成汇总和详细状态报告。 注意
上面指定的“报告详细程度”设置适用于 generate-assessment-report、convert-schema、migrate-data 命令。
使用“错误报告”设置指示错误报告中所需信息的详细程度:
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