Condividi tramite


Generare report (Db2ToSQL)

I report di determinate attività eseguite con i comandi vengono generati nella console di SQL Server Migration Assistant (SSMA) a livello di albero degli oggetti.

Generare un report

Per generare i report, eseguire la procedura seguente:

  1. Specificare il write-summary-report-to parametro . Il report correlato viene archiviato come nome file (se specificato) o nella cartella specificata. Il nome del file è predefinito di sistema come indicato nella tabella seguente, dove <n> è il numero di file univoco che viene incrementato con una cifra con ogni esecuzione dello stesso comando.

    I report sono correlati ai comandi come indicato di seguito:

    Numero di slot Comando Titolo del report
    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

    Importante

    Un report di output è diverso dal report di valutazione. Il primo è un report sulle prestazioni di un comando eseguito, mentre quest'ultimo è un report XML per l'utilizzo a livello di codice.

    Per le opzioni di comando per i report di output (dal numero di slot 2 a 4 nella tabella precedente), vedere la sezione Eseguire la console SSMA.

  2. Indicare l'estensione dei dettagli desiderati nel report di output usando le impostazioni dettaglio report:

    Numero di slot Comando e parametro Descrizione output
    1 verbose="false" Genera un report riepilogato dell'attività.
    2 verbose="true" Genera una relazione sullo stato riepilogato e dettagliato per ogni attività.

    Nota

    Le impostazioni di dettaglio del generate-assessment-reportreport si applicano ai comandi , convert-schemamigrate-data, e convert-sql-statement .

  3. Indicare l'entità dei dettagli desiderati nei report degli errori usando le impostazioni segnalazione errori:

    Numero di slot Comando e parametro Descrizione output
    1 report-errors="false" Nessun dettaglio sui messaggi di errore, avviso o informazioni.
    2 report-errors="true" Messaggi dettagliati di errore, avviso o informazioni.

    Nota

    Le impostazioni di Segnalazione errori si applicano ai generate-assessment-reportcomandi , convert-schemamigrate-data, e convert-sql-statement .

Esempio

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

Comandi del report

synchronize-target

Il comando synchronize-target ha report-errors-to il parametro , che specifica il percorso della segnalazione degli errori per l'operazione di sincronizzazione. Viene quindi creato un file in base al nome TargetSynchronizationReport<n>.xml nel percorso specificato, dove <n> è il numero di file univoco che viene incrementato con una cifra con ogni esecuzione dello stesso comando.

Nota

Se viene specificato il percorso della cartella, report-errors-to il parametro diventa un attributo facoltativo per il comando synchronize-target.

Nell'esempio seguente viene sincronizzato l'intero database di destinazione con tutti gli attributi.

<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 specifica gli oggetti considerati per la sincronizzazione. Può anche avere nomi di oggetto singoli o un nome di oggetto di gruppo.

  • on-error specifica se specificare gli errori di sincronizzazione come avvisi o errori. Opzioni disponibili per on-error:

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

refresh-from-database

Il comando refresh-from-database ha il report-errors-to parametro , che specifica il percorso del report degli errori per l'operazione di aggiornamento. Viene quindi creato un file in base al nome SourceDBRefreshReport<n>.xml nel percorso specificato, dove <n> è il numero di file univoco che viene incrementato con una cifra con ogni esecuzione dello stesso comando.

Se viene specificato il percorso della cartella, report-errors-to il parametro diventa un attributo facoltativo per il comando synchronize-target.

Nell'esempio seguente viene aggiornato l'intero schema con tutti gli attributi.

<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 specifica gli oggetti considerati per l'aggiornamento. Può anche avere nomi di oggetto singoli o un nome di oggetto di gruppo.

  • on-error specifica se specificare gli errori di aggiornamento come avvisi o errori. Opzioni disponibili per on-error:

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