Generieren von Berichten (Db2ToSQL)

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	Befehl	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 von einem 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 den Slotnummern 2–4 in der vorherigen Tabelle) finden Sie im Abschnitt Ausführen der SSMA-Konsole.

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 Ausführlichkeitseinstellungen für Berichte gelten für die Befehle generate-assessment-report, convert-schema, migrate-data und convert-sql-statement.

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

   Die Einstellungen für die Fehlerberichterstattung gelten für die Befehle generate-assessment-report, convert-schema, migrate-data und convert-sql-statement.

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

Befehle für Berichte

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.

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

Aktualisieren-aus-der-Datenbank

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

• Ausführen der SSMA-Konsole