Generowanie raportów (AccessToSQL)

Raporty o niektórych działaniach wykonywanych przy użyciu poleceń są generowane w konsoli SSMA na poziomie drzewa obiektów.

Generowanie raportów

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

1. write-summary-report-to Określ parametr . 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, <n> gdzie jest unikatowym numerem pliku, który zwiększa cyfrę z każdym wykonaniem tego samego polecenia.

   Raporty odnoszą się do poleceń w następujący sposób:

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

   Ważne

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

   Aby zapoznać się z opcjami poleceń dla raportów wyjściowych (z poprzedniego numeru slotu 2–4), zapoznaj się z sekcją Uruchamianie konsoli SSMA.

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

   Numer miejsca	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.

   Uwaga / Notatka

   Ustawienia szczegółowości raportu, określone wcześniej, znajdują zastosowanie dla poleceń generate-assessment-report, convert-schema i migrate-data.

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/informacjach.
   2	report-errors="true"	Szczegółowy komunikat o błędzie/ostrzeżeniu/informacjach.

   Uwaga / Notatka

   Ustawienia raportowania błędów określone wcześniej mają zastosowanie do poleceń 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"
/>

synchronizuj-cel

Polecenie synchronize-target ma report-errors-to parametr , który określa lokalizację raportu o błędach dla operacji synchronizacji. Następnie plik według nazwy 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.

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

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

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

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:

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

odśwież-z-bazy-danych

Polecenie refresh-from-database ma report-errors-to parametr , który określa lokalizację raportu o błędach dla operacji odświeżania. Następnie plik według nazwy 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="$SourceDatabaseStandard$"
    object-type ="Databases"
    on-error="fail-script"
    report-errors-to="$RefreshDBFolder$\RefreshReport.xml"
/>

• 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:

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

Treści powiązane

• Uruchom konsolę SSMA