Rapporten genereren (AccessToSQL)

De rapporten van bepaalde activiteiten die worden uitgevoerd met behulp van opdrachten, worden gegenereerd in de SSMA-console op objectstructuurniveau.

Rapporten genereren

Gebruik de volgende procedure om rapporten te genereren:

1. Geef de write-summary-report-to parameter op. Het gerelateerde rapport wordt opgeslagen als de bestandsnaam (indien opgegeven) of in de map die u opgeeft. De bestandsnaam is systeemgedefinieerd, zoals vermeld in de volgende tabel, waarbij het <n> unieke bestandsnummer is dat wordt verhoogd met een cijfer bij elke uitvoering van dezelfde opdracht.

   De rapporten hebben betrekking op de opdrachten als volgt:

   Slotnummer	Command	Rapporttitel
   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

   Belangrijk

   Een uitvoerrapport verschilt van het evaluatierapport. De vorige is een rapport over de prestaties van een uitgevoerde opdracht, terwijl het laatste een XML-rapport is voor programmatisch verbruik.

   Raadpleeg de sectie SSMA Console uitvoeren voor de opdrachtopties voor uitvoerrapporten (voorheen van sleufnummer 2-4).

2. Geef de gewenste details in het uitvoerrapport aan met behulp van de instellingen voor uitgebreidheid van rapporten:

   Slotnummer	Opdracht en parameter	Beschrijving van uitvoer
   1	verbose="false"	Hiermee wordt een samengevat rapport van de activiteit gegenereerd.
   2	verbose="true"	Hiermee genereert u een samengevat en gedetailleerd statusrapport voor elke activiteit.

   Opmerking

   De eerder opgegeven rapportverbosity-instellingen zijn van toepassing op generate-assessment-report, convert-schema, migrate-data commands.

3. Geef de gewenste details aan in de foutrapporten met behulp van de instellingen voor foutrapportage:

   Slotnummer	Opdracht en parameter	Beschrijving van uitvoer
   1	report-errors="false"	Geen details over foutmeldingen/waarschuwingsberichten/informatieberichten.
   2	report-errors="true"	Gedetailleerde fout-/waarschuwings-/infoberichten.

   Opmerking

   De eerder opgegeven instellingen voor foutrapportage zijn van toepassing op generate-assessment-report, convert-schema, migrate-data commands.

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

synchronisatiedoel

De opdracht synchronize-target heeft report-errors-to een parameter, die de locatie van het foutenrapport voor de synchronisatiebewerking aangeeft. Vervolgens wordt een bestand op naam TargetSynchronizationReport<n>.xml gemaakt op de opgegeven locatie, waarbij <n> het unieke bestandsnummer is dat wordt verhoogd met een cijfer bij elke uitvoering van dezelfde opdracht.

Als het mappad wordt opgegeven, dan wordt de parameter report-errors-to een optioneel kenmerk voor de opdracht synchronize-target.

In het volgende voorbeeld wordt de hele database gesynchroniseerd met alle kenmerken:

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

object-name: Hiermee geeft u de objecten op die worden overwogen voor synchronisatie (het kan ook afzonderlijke objectnamen of een groepsobjectnaam hebben).

• on-error: Hiermee geeft u op of synchronisatiefouten moeten worden opgegeven als waarschuwingen of fouten. Beschikbare opties:

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

verversen vanuit database

De opdracht refresh-from-database heeft report-errors-to een parameter, die de locatie van het foutenrapport voor de vernieuwingsbewerking aangeeft. Vervolgens wordt een bestand op naam SourceDBRefreshReport<n>.xml gemaakt op de opgegeven locatie, waarbij <n> het unieke bestandsnummer is dat wordt verhoogd met een cijfer bij elke uitvoering van dezelfde opdracht.

Als het mappad wordt opgegeven, dan wordt de parameter report-errors-to een optioneel kenmerk voor de opdracht synchronize-target.

In het volgende voorbeeld wordt het hele schema vernieuwd met alle kenmerken:

<refresh-from-database
    object-name="$SourceDatabaseStandard$"
    object-type ="Databases"
    on-error="fail-script"
    report-errors-to="$RefreshDBFolder$\RefreshReport.xml"
/>

• object-name: Hiermee geeft u de objecten op die worden beschouwd voor vernieuwing (het kan ook afzonderlijke objectnamen of een groepsobjectnaam hebben).

• on-error: Hiermee geeft u op of vernieuwingsfouten moeten worden opgegeven als waarschuwingen of fouten. Beschikbare opties:

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

Verwante inhoud

• De SSMA-console uitvoeren