產生報告（AccessToSQL）

使用命令執行的特定活動報表會在物件樹狀結構層級的 SSMA 主控台中產生。

產生報表

使用下列程序產生報表：

1. 請指定參數。write-summary-report-to 在您指定的資料夾中，相關報表會儲存為檔案名稱 (如果指定)。 檔案名稱為系統預設，如下表所述， <n> 其中 是唯一檔案號，每次執行同一指令時會增加一位數字。

   這些報告與指揮部相關內容如下：

   車位號碼	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 報表。

   有關輸出報告的指令選項（之前的槽號 2 到 4），請參閱執行 SSMA 主控台 部分。

2. 使用 [報表詳細程度] 設定，指出您在輸出報表中所需的詳細資料範圍：

   車位號碼	指令與參數	輸出描述
   1	verbose="false"	產生活動的摘要報表。
   2	verbose="true"	產生每個活動的摘要和詳細狀態報表。

   注意

   先前指定的報告詳述設定適用於產生評估報告、轉換架構、遷移資料指令。

3. 使用 [錯誤報表] 設定，指出您在錯誤報表中所需的詳細資料範圍：

   車位號碼	指令與參數	輸出描述
   1	report-errors="false"	沒有錯誤/警告/資訊訊息的詳細資料。
   2	report-errors="true"	詳細錯誤/警告/資訊訊息。

   注意

   先前指定的錯誤回報設定適用於產生-評估-報告、轉換結構、遷移-資料指令。

Example

<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的可選屬性。

以下範例將整個資料庫與所有屬性同步：

<synchronize-target
    object-name="$TargetDB$.dbo"
    on-error="fail-script"
    report-errors-to="$SynchronizationReports$"
/>

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的可選屬性。

以下範例將整個架構中的所有屬性重新整理：

<refresh-from-database
    object-name="$SourceDatabaseStandard$"
    object-type ="Databases"
    on-error="fail-script"
    report-errors-to="$RefreshDBFolder$\RefreshReport.xml"
/>

• object-name： 指定考慮刷新的物件（也可以是個別物件名稱或群組物件名稱）。

• on-error：指定是否要將重新整理錯誤指定為警告或錯誤。 可用選項：

  • report-total-as-warning
  • report-each-as-warning
  • fail-script

相關內容

• 執行 SSMA 主控台