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. Indica il livello di dettaglio desiderato nel report di output usando le impostazioni di verbosità del report.

    Numero di slot Comando e parametro Descrizione dell'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 report si applicano ai comandi generate-assessment-report, convert-schema, migrate-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 dell'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 comandi generate-assessment-report, convert-schema, migrate-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

aggiorna dal 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