Создание отчетов (AccessToSQL)

Отчеты о определенных действиях, выполняемых с помощью команд, создаются в консоли SSMA на уровне дерева объектов.

Создание отчетов

Используйте следующую процедуру для создания отчетов:

1. write-summary-report-to Укажите параметр. Связанный отчет хранится в виде имени файла (если указано) или в указанной папке. Имя файла является системным, как упоминалось в следующей таблице, где это уникальный номер файла, <n> который увеличивается с цифрой с каждой выполнением той же команды.

   Отчеты относятся к командам следующим образом:

   Номер слота	Команда	Заголовок отчета
   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"	Создает сводный и подробный отчет о состоянии для каждого действия.

   Примечание.

   Указанные ранее параметры детализации отчета применимы для команд generate-assessment-report, convert-schema, migrate-data.

3. Укажите степень детализации в отчетах об ошибках с помощью параметров отчетов об ошибках:

   Номер слота	Команда и параметр	Описание выходных данных
   1	report-errors="false"	Нет сведений об ошибках, предупреждениях и сообщениях сведений.
   2	report-errors="true"	Подробные сообщения об ошибках, предупреждениях и сведениях.

   Примечание.

   Указанные ранее параметры отчетов об ошибках применимы для команд generate-assessment-report, convert-schema, migrate-data.

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 Команда имеет 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 есть параметр 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