Generación de informes (Db2ToSQL)

Los informes de determinadas actividades realizadas mediante comandos se generan en la consola de SQL Server Migration Assistant (SSMA) en el nivel de árbol de objetos.

Generación de un informe

Use el siguiente procedimiento para generar informes:

1. Especifique el write-summary-report-to parámetro . El informe relacionado se almacena como el nombre de archivo (si se especifica) o en la carpeta que especifique. El nombre de archivo está predefinido por el sistema como se mencionó en la tabla siguiente, donde <n> es el número de archivo único que se incrementa con un dígito con cada ejecución del mismo comando.

   Los informes están relacionados con los comandos de la manera siguiente:

   Número de ranura	Get-Help	Título del informe
   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

   Importante

   Un informe de salida es diferente del informe de evaluación. El primero es un informe sobre el rendimiento de un comando ejecutado, mientras que este último es un informe XML para el consumo mediante programación.

   Para ver las opciones de comando de los informes de salida (del número de ranura 2 a 4 de la tabla anterior), consulte la sección Ejecutar la consola SSMA.

2. Indique la extensión de detalle que desee en el informe de salida mediante la Configuración de nivel de detalle del informe:

   Número de ranura	Comando y parámetro	Descripción de la salida
   1	verbose="false"	Genera un informe resumido de la actividad.
   2	verbose="true"	Genera un informe de estado resumido y detallado para cada actividad.

   Nota:

   La configuración de detalle del informe se aplica a los generate-assessment-reportcomandos , convert-schema, migrate-datay convert-sql-statement .

3. Indique la extensión de detalle que desee en los informes de error mediante la configuración de informes de errores:

   Número de ranura	Comando y parámetro	Descripción de la salida
   1	report-errors="false"	No hay detalles sobre los mensajes de error, advertencia o información.
   2	report-errors="true"	Mensajes detallados de error, advertencia o información.

   Nota:

   La configuración de informes de errores se aplica a los generate-assessment-reportcomandos , convert-schema, migrate-datay convert-sql-statement .

Ejemplo

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

Comandos de informe

synchronize-target

El comando synchronize-target tiene report-errors-to el parámetro , que especifica la ubicación del informe de errores para la operación de sincronización. A continuación, se crea un archivo por nombre TargetSynchronizationReport<n>.xml en la ubicación especificada, donde <n> es el número de archivo único que se incrementa con un dígito con cada ejecución del mismo comando.

Nota:

Si se proporciona la ruta de acceso de la carpeta, el report-errors-to parámetro se convierte en un atributo opcional para el comando synchronize-target.

En el ejemplo siguiente se sincroniza toda la base de datos de destino con todos los atributos.

<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 especifica los objetos considerados para la sincronización. También puede tener nombres de objeto individuales o un nombre de objeto de grupo.

• on-error especifica si se deben especificar errores de sincronización como advertencias o errores. Opciones disponibles para on-error:

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

refresh-from-database

El comando refresh-from-database tiene el report-errors-to parámetro , que especifica la ubicación del informe de errores para la operación de actualización. A continuación, se crea un archivo por nombre SourceDBRefreshReport<n>.xml en la ubicación especificada, donde <n> es el número de archivo único que se incrementa con un dígito con cada ejecución del mismo comando.

Si se proporciona la ruta de acceso de la carpeta, el report-errors-to parámetro se convierte en un atributo opcional para el comando synchronize-target.

En el ejemplo siguiente se actualiza todo el esquema con todos los atributos.

<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 especifica los objetos considerados para la actualización. También puede tener nombres de objeto individuales o un nombre de objeto de grupo.

• on-error especifica si se deben especificar errores de actualización como advertencias o errores. Opciones disponibles para on-error:

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

Contenido relacionado

• Ejecución de la consola de SSMA (Db2ToSQL)