產生報告 (AccessToSQL)
使用命令執行的特定活動報表會在物件樹狀結構層級的 SSMA 主控台中產生。
使用下列程序產生報表:
指定 write-summary-report-to 參數。 在您指定的資料夾中,相關報表會儲存為檔案名稱 (如果指定)。 檔案名稱是系統預先定義的,如下表所述,其中 <n> 是唯一的檔案編號,每次執行相同命令時都會遞增一個數字。
報表 vis-à-vis 命令如下:
Sl. 不會。 Command 報表標題 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 報表。
如需輸出報表的命令選項 (從上述 Sl 第 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 參數,指定同步處理作業的錯誤報表位置。 然後,會在指定位置依名稱 TargetSynchronizationReport<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