Générer des rapports (AccessToSQL)

Les rapports de certaines activités effectuées à l’aide de commandes sont générés dans la console SSMA au niveau de l’arborescence des objets.

Générer des rapports

Utilisez la procédure suivante pour générer des rapports :

1. Spécifiez le write-summary-report-to paramètre. Le rapport associé est stocké en tant que nom de fichier (si spécifié) ou dans le dossier que vous spécifiez. Le nom de fichier est prédéfini par le système, comme indiqué dans le tableau suivant, <n> où est le numéro de fichier unique qui incrémente avec un chiffre avec chaque exécution de la même commande.

   Les rapports sont liés aux commandes comme suit :

   Numéro d’emplacement	Commande	Titre du rapport
   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

   Important

   Un rapport de sortie est différent du rapport d’évaluation. L’ancien est un rapport sur les performances d’une commande exécutée, tandis que celui-ci est un rapport XML pour la consommation par programmation.

   Pour connaître les options de commande des rapports de sortie (à partir du numéro d’emplacement 2-4 précédemment), reportez-vous à la section Exécuter la console SSMA .

2. Indiquez l’étendue des détails souhaités dans le rapport de sortie à l’aide des paramètres de détail du rapport :

   Numéro d’emplacement	Commande et paramètre	Description de la sortie
   1	verbose="false"	Génère un rapport résumé de l’activité.
   2	verbose="true"	Génère un rapport d’état résumé et détaillé pour chaque activité.

   Remarque

   Les paramètres de détail du rapport spécifiés précédemment s'appliquent aux commandes generate-assessment-report, convert-schema, migrate-data.

3. Indiquez l’étendue des détails souhaités dans les rapports d’erreurs à l’aide des paramètres de rapport d’erreurs :

   Numéro d’emplacement	Commande et paramètre	Description de la sortie
   1	report-errors="false"	Aucun détail sur les messages d’erreur/d’avertissement/d’informations.
   2	report-errors="true"	Messages d’erreur/d’avertissement/d’informations détaillés.

   Remarque

   Les paramètres de rapport d’erreurs spécifiés précédemment s’appliquent aux commandes 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

La commande synchronize-target a report-errors-to un paramètre, qui spécifie l’emplacement du rapport d’erreur pour l’opération de synchronisation. Ensuite, un fichier par nom TargetSynchronizationReport<n>.xml est créé à l’emplacement spécifié, où <n> est le numéro de fichier unique qui incrémente avec un chiffre avec chaque exécution de la même commande.

Si le chemin d’accès au dossier est donné, le report-errors-to paramètre devient un attribut facultatif pour la commande synchronize-target.

L’exemple suivant synchronise l’intégralité de la base de données avec tous les attributs :

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

object-name: spécifie les objets pris en compte pour la synchronisation (il peut également avoir des noms d’objets individuels ou un nom d’objet de groupe).

• on-error: spécifie s’il faut spécifier des erreurs de synchronisation en tant qu’avertissements ou erreur. Options disponibles :

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

refresh-from-database

La commande refresh-from-database a report-errors-to un paramètre, qui spécifie l’emplacement du rapport d’erreur pour l’opération d’actualisation. Ensuite, un fichier par nom SourceDBRefreshReport<n>.xml est créé à l’emplacement spécifié, où <n> est le numéro de fichier unique qui incrémente avec un chiffre avec chaque exécution de la même commande.

Si le chemin d’accès au dossier est donné, le report-errors-to paramètre devient un attribut facultatif pour la commande synchronize-target.

L’exemple suivant actualise l’intégralité du schéma avec tous les attributs :

<refresh-from-database
    object-name="$SourceDatabaseStandard$"
    object-type ="Databases"
    on-error="fail-script"
    report-errors-to="$RefreshDBFolder$\RefreshReport.xml"
/>

• object-name: spécifie les objets pris en compte pour l’actualisation (il peut également avoir des noms d’objets individuels ou un nom d’objet de groupe).

• on-error: spécifie s’il faut spécifier des erreurs d’actualisation en tant qu’avertissements ou erreur. Options disponibles :

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

Contenu connexe

• Exécuter la console SSMA