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

Отчеты о определенных действиях, выполняемых с помощью команд, создаются в консоли Помощник по миграции SQL Server (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	convert-sql-statement	ConvertSQLReport<n>.xml
   5	synchronize-target	TargetSynchronizationReport<n>.xml
   6	refresh-from-database	SourceDBRefreshReport<n>.xml

   Внимание

   Выходной отчет отличается от отчета об оценке. Первый — это отчет о производительности выполняемой команды, а последний — XML-отчет для программного потребления.

   Параметры команд для выходных отчетов (из номеров слотов с 2 по 4 в предыдущей таблице) см. в разделе Исполнение консольной команды SSMA.

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

   Номер слота	Команда и параметр	Описание выходных данных
   1	verbose="false"	Создает сводный отчет о действии.
   2	verbose="true"	Создает сводный и подробный отчет о состоянии для каждого действия.

   Примечание.

   Настройки подробности отчетов применяются к командам generate-assessment-report, convert-schema, migrate-data и convert-sql-statement.

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

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

   Примечание.

   Параметры отчетов об ошибках применяются к командам generate-assessment-report, convert-schema, migrate-data и convert-sql-statement.

Пример

<generate-assessment-report
   object-name="<object-name>"
   object-type="<object-type>"
   verbose="<true/false>"
   report-errors="<true/false>"
   write-summary-report-to="<file-name/folder-name>"
   assessment-report-folder="<folder-name>"
   assessment-report-overwrite="<true/false>"/>

Команды для отчетов

синхронизация целевого объекта

У команды synchronize-target есть параметр report-errors-to, для указания расположения отчета об ошибке операции синхронизации. Затем файл по имени TargetSynchronizationReport<n>.xml создается в указанном расположении, где <n> находится уникальный номер файла, который увеличивается с цифрой при каждом выполнении той же команды.

В следующем примере выполняется синхронизация всей целевой базы данных со всеми атрибутами.

<synchronize-target
   object-name="<object-name>"
   on-error="report-total-as-warning/report-each-as-warning/fail-script"
   report-errors-to="<file-name/folder-name>"/>

• object-name указывает объекты, которые рассматриваются для синхронизации. Кроме того, у него могут быть отдельные имена объектов или имя объекта группы.

• on-error указывает, следует ли указывать ошибки синхронизации в качестве предупреждений или ошибок. Доступные варианты: on-error

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

обновление из базы данных

Параметр report-errors-to команды refresh-from-database указывает расположение отчета об ошибке для операции обновления. Затем файл по имени SourceDBRefreshReport<n>.xml создается в указанном расположении, где <n> находится уникальный номер файла, который увеличивается с цифрой при каждом выполнении той же команды.

Если путь к папке задан, report-errors-to параметр становится необязательным атрибутом для команды synchronize-target.

Следующий пример обновляет всю схему со всеми атрибутами.

<refresh-from-database
   object-name="<object-name>"
   object-type ="<object-type>"
   on-error="report-total-as-warning/report-each-as-warning/fail-script"
   report-errors-to="<file-name/folder-name>"/>

• object-name указывает объекты, которые рассматриваются для обновления. Кроме того, у него могут быть отдельные имена объектов или имя объекта группы.

• on-error указывает, следует ли указывать ошибки обновления в качестве предупреждений или ошибок. Доступные варианты для on-error:

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

Связанный контент

• Выполнение консоли SSMA (Db2ToSQL)