レポートの生成 (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 レポートです。
出力レポートのコマンド オプション (上記の Sl. No. 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-erors="yes"
write-summary-report-to="$AssessmentFolder$\Report1.xml"
assessment-report-folder="$AssessmentFolder$\assesment_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