Generowanie raportów (Db2ToSQL)

Raporty o niektórych działaniach wykonywanych przy użyciu poleceń są generowane w konsoli programu SQL Server Migration Assistant (SSMA) na poziomie drzewa obiektów.

Generowanie raportu

Aby wygenerować raporty, użyj następującej procedury:

1. Określ parametr write-summary-report-to. Powiązany raport jest przechowywany jako nazwa pliku (jeśli określono) lub w określonym folderze. Nazwa pliku jest wstępnie zdefiniowana przez system, jak wspomniano w poniższej tabeli, gdzie <n> jest unikatowym numerem pliku, który zwiększa cyfrę z każdym wykonaniem tego samego polecenia.

   Raporty są powiązane z poleceniami w następujący sposób:

   Numer miejsca	Polecenie	Tytuł raportu
   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

   Ważny

   Raport wyjściowy różni się od raportu oceny. Pierwszy jest raportem dotyczącym wydajności wykonanego polecenia, a drugi jest raportem XML na potrzeby użycia programowego.

   Aby zapoznać się z opcjami poleceń dla raportów wyjściowych (z gniazd numer 2 - 4 w poprzedniej tabeli), przejdź do sekcji Wykonaj konsolę SSMA.

2. Określ zakres szczegółów, których potrzebujesz w raporcie wyjściowym, używając ustawień szczegółowości raportu:

   Numer slotu	Polecenie i parametr	Opis danych wyjściowych
   1	verbose="false"	Generuje podsumowany raport działania.
   2	verbose="true"	Generuje podsumowany i szczegółowy raport o stanie dla każdego działania.

   Notatka

   Ustawienia szczegółowości raportu mają zastosowanie do poleceń generate-assessment-report, convert-schema, migrate-datai convert-sql-statement.

3. Określ zakres szczegółów, których potrzebujesz w raportach o błędach, używając ustawień raportowania błędów:

   Numer miejsca	Polecenie i parametr	Opis danych wyjściowych
   1	report-errors="false"	Brak szczegółów dotyczących komunikatów o błędach, ostrzeżeniach lub informacjach.
   2	report-errors="true"	Szczegółowy błąd, ostrzeżenie lub komunikaty informacyjne.

   Notatka

   Ustawienia raportowania błędów dotyczą poleceń generate-assessment-report, convert-schema, migrate-datai convert-sql-statement.

Przykład

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

Polecenia raportu

synchronizuj-cel

Polecenie synchronize-target ma parametr report-errors-to, który określa lokalizację raportu o błędach dla operacji synchronizacji. Następnie plik o nazwie TargetSynchronizationReport<n>.xml jest tworzony w określonej lokalizacji, gdzie <n> jest unikatowym numerem pliku, który zwiększa cyfrę z każdym wykonaniem tego samego polecenia.

Poniższy przykład synchronizuje całą docelową bazę danych ze wszystkimi atrybutami.

<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 określa obiekty rozważane do synchronizacji. Może również mieć nazwy poszczególnych obiektów lub nazwę obiektu grupy.

• on-error określa, czy należy określić błędy synchronizacji jako ostrzeżenia lub błąd. Dostępne opcje dla on-error:

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

odśwież z bazy danych

Polecenie refresh-from-database ma parametr report-errors-to, który określa lokalizację raportu o błędach dla operacji odświeżania. Następnie plik o nazwie SourceDBRefreshReport<n>.xml jest tworzony w określonej lokalizacji, gdzie <n> jest unikatowym numerem pliku, który zwiększa cyfrę z każdym wykonaniem tego samego polecenia.

Jeśli zostanie podana ścieżka folderu, report-errors-to parametr stanie się opcjonalnym atrybutem dla polecenia synchronize-target.

Poniższy przykład odświeża cały schemat ze wszystkimi atrybutami.

<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 określa obiekty rozważane do odświeżenia. Może również mieć nazwy poszczególnych obiektów lub nazwę obiektu grupy.

• on-error określa, czy należy określić błędy odświeżania jako ostrzeżenia lub błąd. Dostępne opcje dla on-error:

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

Powiązana zawartość

• Uruchom konsolę SSMA (Db2ToSQL)