Geração de relatórios (DB2ToSQL)
Os relatórios de determinadas atividades executadas ao usar comandos são gerados no Console do SSMA no nível da árvore de objetos.
Use o procedimento apresentado a seguir para gerar relatórios:
Especifique o parâmetro write-summary-report-to. O relatório relacionado é armazenado como o nome do arquivo (se especificado) ou na pasta que você especificar. O nome do arquivo é definido previamente pelo sistema conforme mencionado na tabela abaixo, em que <n> corresponde ao número do arquivo exclusivo que é incrementado com um dígito a cada execução do mesmo comando.
Os relatórios em relação aos comandos são:
N.º de série Não. Comando Título do relatório 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
Um relatório de saída é diferente de um Relatório de Avaliação. O primeiro corresponde a um relatório sobre o desempenho de um comando executado, enquanto o último é um relatório XML para consumo programático.
Para obter as opções de comando para relatórios de saída (do n.º de série 2 a 4 acima), consulte a seção Executar o Console do SSMA (DB2ToSQL).
Indique a extensão de detalhes que você deseja no relatório de saída ao usar as configurações de Detalhamento do Relatório:
N.º de série Não. Comando e parâmetro Descrição da saída 1 verbose="false" Gera um relatório resumido da atividade. 2 verbose="true" Gera um relatório de progresso resumido e detalhado para cada atividade. Observação
As Configurações de detalhamento do relatório especificadas acima são aplicáveis aos comandos generate-assessment-report, convert-schema, migrate-data, convert-sql-statement.
Indique a extensão de detalhes que você deseja nos relatórios de erros ao usar as configurações do Relatório de Erros:
N.º de série Não. Comando e parâmetro Descrição da saída 1 report-errors="false" Não há detalhes sobre mensagens de erro, de aviso ou de informações. 2 report-errors="true" Mensagens detalhadas de erro, de aviso e de informações. Observação
As Configurações de Relatório de Erros especificadas acima são aplicáveis aos comandos generate-assessment-report, convert-schema, migrate-data, convert-sql-statement.
Exemplo:
<generate-assessment-report
object-name="<object-name>"
object-type="<object-type>"
verbose="<true/false>"
report-erors="<true/false>"
write-summary-report-to="<file-name/folder-name>"
assessment-report-folder="<folder-name>"
assessment-report-overwrite="<true/false>"/>
synchronize-target:
O comando synchronize-target possui o parâmetro report-errors-to, que especifica o local do relatório de erros para a operação de sincronização. Em seguida, um arquivo chamado TargetSynchronizationReport<n>.XML é criado no local especificado, em que <n> corresponde ao número do arquivo exclusivo que é incrementado com um dígito a cada execução do mesmo comando.
Observação: se o caminho da pasta for fornecido, o parâmetro “report-errors-to” se tornará um atributo opcional para o comando “synchronize-target”.
<!-- Example: Synchronize target entire Database with all attributes-->
<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: especifica os objetos considerados para sincronização (e também pode ter nomes de objetos individuais ou um nome de objeto para um grupo).
on-error: especifica se erros de sincronização devem ser especificados como avisos ou erros. Opções disponíveis para o on-error:
report-total-as-warning
report-each-as-warning
fail-script
refresh-from-database:
O comando refresh-from-database possui o parâmetro report-errors-to, que especifica o local do relatório de erros para a operação de atualização. Em seguida, um arquivo chamado SourceDBRefreshReport<n>.XML é criado no local especificado, em que <n> corresponde ao número do arquivo exclusivo que é incrementado com um dígito a cada execução do mesmo comando.
Observação: se o caminho da pasta for fornecido, o parâmetro “report-errors-to” se tornará um atributo opcional para o comando “synchronize-target”.
<!-- Example: Refresh entire Schema (with all attributes)-->
<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: especifica os objetos considerados para atualização (e também pode ter nomes de objetos individuais ou um nome de objeto para um grupo).
on-error: especifica se erros de atualização devem ser especificados como avisos ou erros. Opções disponíveis para o on-error:
report-total-as-warning
report-each-as-warning
fail-script