Partager via

Générer des rapports (Db2ToSQL)

  • Article

Les rapports de certaines activités effectuées à l’aide de commandes sont générés dans Assistant Migration SQL Server console (SSMA) au niveau de l’arborescence des objets.

Générer un rapport

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, où <n> 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 convert-sql-statement ConvertSQLReport<n>.xml
    5 synchronize-target TargetSynchronizationReport<n>.xml
    6 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 ce dernier 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 dans le tableau précédent), 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 s’appliquent aux commandes et convert-schemamigrate-dataconvert-sql-statement aux generate-assessment-reportcommandes.

  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 ou d’informations.
    2 report-errors="true" Erreur détaillée, avertissement ou messages d’informations.

    Remarque

    Les paramètres de création de rapports d’erreurs s’appliquent aux commandes et convert-schemamigrate-dataconvert-sql-statement aux generate-assessment-reportcommandes.

Exemple

<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>"/>

Commandes de rapport

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.

Remarque

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 cible avec tous les attributs.

<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 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 pour on-error:

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

refresh-from-database

La commande refresh-from-database a le report-errors-to 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="<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 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 pour on-error:

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

Contenu connexe