Freigeben über

Generieren von Berichten (Db2ToSQL)

  • Artikel

Die Berichte bestimmter Aktivitäten, die mithilfe von Befehlen ausgeführt werden, werden auf Objektstrukturebene in der SQL Server-Migrations-Assistent-Konsole (SSMA) generiert.

Generieren eines Berichts

Verwenden Sie das folgende Verfahren, um Berichte zu generieren:

  1. Geben Sie den write-summary-report-to Parameter an. Der zugehörige Bericht wird als Dateiname (sofern angegeben) oder im von Ihnen angegebenen Ordner gespeichert. Der Dateiname ist systemdefiniert, wie in der folgenden Tabelle erwähnt. Dabei handelt es sich um die eindeutige Dateinummer, <n> die mit jeder Ausführung desselben Befehls mit einer Ziffer erhöht wird.

    Die Berichte beziehen sich wie folgt auf die Befehle:

    Steckplatznummer Get-Help Berichtstitel
    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

    Wichtig

    Ein Ausgabebericht unterscheidet sich vom Bewertungsbericht. Der erste ist ein Bericht über die Leistung eines ausgeführten Befehls, während letztere ein XML-Bericht für den programmgesteuerten Verbrauch ist.

    Informationen zu den Befehlsoptionen für Ausgabeberichte (aus der Steckplatznummer 2 - 4 in der vorherigen Tabelle) finden Sie im Abschnitt "Ausführen des SSMA-Konsolenabschnitts ".

  2. Geben Sie den Umfang der Details an, die Sie im Ausgabebericht wünschen, indem Sie die Einstellungen für die Ausführlichkeit des Berichts verwenden:

    Steckplatznummer Befehl und Parameter Ausgabebeschreibung
    1 verbose="false" Generiert einen zusammengefassten Bericht der Aktivität.
    2 verbose="true" Generiert einen zusammengefassten und detaillierten Statusbericht für jede Aktivität.

    Hinweis

    Die Verbosity-Einstellungen für Berichte gelten für die generate-assessment-reportBefehle , convert-schema, und migrate-dataconvert-sql-statement die Befehle.

  3. Geben Sie den Umfang der Details an, die Sie in den Fehlerberichten wünschen, indem Sie die Einstellungen für die Fehlerberichterstattung verwenden:

    Steckplatznummer Befehl und Parameter Ausgabebeschreibung
    1 report-errors="false" Keine Details zu Fehler-, Warn- oder Informationsmeldungen.
    2 report-errors="true" Detaillierte Fehler-, Warnungs- oder Informationsmeldungen.

    Hinweis

    Fehlerberichterstattungseinstellungen gelten für die generate-assessment-reportBefehle , convert-schema, , migrate-dataund convert-sql-statement die Befehle.

Beispiel

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

Berichtsbefehle

synchronize-target

Der Befehl synchronize-target verfügt über report-errors-to einen Parameter, der den Speicherort des Fehlerberichts für den Synchronisierungsvorgang angibt. Anschließend wird eine Datei anhand des Namens TargetSynchronizationReport<n>.xml an dem angegebenen Speicherort erstellt, wobei <n> die eindeutige Dateinummer angegeben ist, die mit einer Ziffer mit jeder Ausführung desselben Befehls erhöht wird.

Hinweis

Wenn der Ordnerpfad angegeben wird, wird der report-errors-to Parameter zu einem optionalen Attribut für den Befehl synchronize-target.

Im folgenden Beispiel wird die gesamte Zieldatenbank mit allen Attributen synchronisiert.

<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 Gibt die Objekte an, die für die Synchronisierung berücksichtigt werden. Sie kann auch über einzelne Objektnamen oder einen Gruppenobjektnamen verfügen.

  • on-error Gibt an, ob Synchronisierungsfehler als Warnungen oder Fehler angegeben werden sollen. Verfügbare Optionen für on-error:

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

refresh-from-database

Der Befehl refresh-from-database verfügt über den report-errors-to Parameter, der den Speicherort des Fehlerberichts für den Aktualisierungsvorgang angibt. Anschließend wird eine Datei anhand des Namens SourceDBRefreshReport<n>.xml an dem angegebenen Speicherort erstellt, wobei <n> die eindeutige Dateinummer angegeben ist, die mit einer Ziffer mit jeder Ausführung desselben Befehls erhöht wird.

Wenn der Ordnerpfad angegeben wird, wird der report-errors-to Parameter zu einem optionalen Attribut für den Befehl synchronize-target.

Im folgenden Beispiel wird das gesamte Schema mit allen Attributen aktualisiert.

<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 Gibt die Objekte an, die für die Aktualisierung berücksichtigt werden. Sie kann auch über einzelne Objektnamen oder einen Gruppenobjektnamen verfügen.

  • on-error Gibt an, ob Aktualisierungsfehler als Warnungen oder Fehler angegeben werden sollen. Verfügbare Optionen für on-error:

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

Zugehöriger Inhalt