Generación de informes (AccessToSQL)

Los informes de determinadas actividades realizadas mediante comandos se generan en la consola de SSMA en el nivel de árbol de objetos.

Generación de informes

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 es <n> el número de archivo único que se incrementa con un dígito con cada ejecución del mismo comando.

   Los informes se relacionan con los comandos de la manera siguiente:

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

   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-4 anteriormente), consulte la sección Ejecutar la consola de 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 verbosidad del informe especificada anteriormente es aplicable a los comandos generate-assessment-report, convert-schema, migrate-data.

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 especificada anteriormente se aplica a los comandos generate-assessment-report, convert-schema y 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

El comando synchronize-target tiene el parámetro report-errors-to, que especifica la ubicación del reporte 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.

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 con todos los atributos:

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

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:

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

refresh-from-database

El comando refresh-from-database tiene el parámetro report-errors-to, 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="$SourceDatabaseStandard$"
    object-type ="Databases"
    on-error="fail-script"
    report-errors-to="$RefreshDBFolder$\RefreshReport.xml"
/>

• 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 especifican los errores de actualización como advertencias o errores. Opciones disponibles:

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

Contenido relacionado

• Ejecución de la consola de SSMA