Generazione di report (AccessToSQL)
I report di determinate attività eseguite usando i comandi vengono generati nella console SSMA a livello di albero degli oggetti.
Per generare lo script, eseguire la procedura seguente:
Specificare il parametro write-summary-report-to. Il report correlato viene archiviato come nome file (se specificato) o nella cartella specificata. Il nome del file è predefinito dal sistema come indicato nella tabella seguente, dove <n> è il numero di file unico che viene incrementato con una cifra con ogni esecuzione dello stesso comando.
I report rispetto ai comandi sono:
Sl. No. Comando Titolo del report 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 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 il consumo programmatico.
Per le opzioni di comando per i report di output (da Sl. N. 2-4 sopra), vedere la sezione Esecuzione della console SSMA (AccessToSQL).
Indicare il grado di dettaglio desiderato nel report di output usando le impostazioni dettaglio report:
Sl. No. Comando e parametro Descrizione output 1 verbose="false" Genera un report riepilogato dell'attività. 2 verbose="true" Genera un report di stato riepilogato e dettagliato per ogni attività. Nota
Le impostazioni di dettaglio dei report specificate in precedenza sono applicabili ai comandi generate-assessment-report, convert-schema e migrate-data.
Indicare il grado di dettaglio desiderato nei report degli errori usando le impostazioni segnalazione errori:
Sl. No. Comando e parametro Descrizione output 1 report-errors="false" Nessun dettaglio sui messaggi di errore/avviso/informazioni. 2 report-errors="true" Messaggi dettagliati di errore/avviso/informazioni. Nota
Le impostazioni di segnalazione errori specificate in precedenza sono applicabili per i comandi generate-assessment-report, convert-schema, migrate-data.
Esempio:
<generate-assessment-report
object-name="testschema"
object-type="Schemas"
verbose="yes"
report-erors="yes"
write-summary-report-to="$AssessmentFolder$\Report1.xml"
assessment-report-folder="$AssessmentFolder$\assesment_report"
assessment-report-overwrite="true"
/>
synchronize-target:
Il comando synchronize-target include il parametro report-errors-to, che specifica la posizione del report degli errori per l'operazione di sincronizzazione. Viene quindi creato un file per nome TargetSynchronizationReport<n>.XML nella posizione specificata, dove <n> è il numero di file unico che viene incrementato con una cifra con ogni esecuzione dello stesso comando.
Nota: se viene specificato il percorso della cartella, il parametro 'report-errors-to' diventa un attributo facoltativo per il comando 'synchronize-target'.
<!-- Example: Synchronize target entire Database with all attributes-->
<synchronize-target
object-name="$TargetDB$.dbo"
on-error="fail-script"
report-errors-to="$SynchronizationReports$"
/>
object-name: specifica gli oggetti considerati per la sincronizzazione (può anche avere singoli nomi di oggetto o un nome di oggetto gruppo).
on-error: specifica se indicare 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 include il parametro report-errors-to, che specifica la posizione del report degli errori per l'operazione di aggiornamento. Viene quindi creato un file in base al nome SourceDBRefreshReport<n>.XML nella posizione specificata, dove <n> è il numero di file unico che viene incrementato con una cifra con ogni esecuzione dello stesso comando.
Nota: se viene specificato il percorso della cartella, il parametro 'report-errors-to' diventa un attributo facoltativo per il comando 'synchronize-target'.
<!-- Example: Refresh entire Schema (with all attributes)-->
<refresh-from-database
object-name="$SourceDatabaseStandard$"
object-type ="Databases"
on-error="fail-script"
report-errors-to="$RefreshDBFolder$\RefreshReport.xml"
/>
object-name: specifica gli oggetti considerati per l'aggiornamento (può anche avere singoli nomi di oggetto o un nome di oggetto gruppo).
on-error: specifica se indicare gli errori di aggiornamento come avvisi o errori. Opzioni disponibili per on-error:
report-total-as-warning
report-each-as-warning
fail-script