Gerar relatórios (AccessToSQL)
Os relatórios de determinadas atividades executadas ao usar comandos são gerados no Console do SSMA no nível da árvore de objetos.
Para gerar os relatórios, use o seguinte procedimento:
Especifique o parâmetro write-summary-report-to. O relatório relacionado é armazenado como o nome do arquivo (se especificado) ou na pasta especificada. O nome do arquivo é predefinido pelo sistema, conforme mencionado na tabela abaixo, onde <n> é o número de arquivo exclusivo incrementado com um dígito a cada execução do mesmo comando.
Os relatórios em relação aos comandos são:
Sl. 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 synchronize-target TargetSynchronizationReport<n>.XML 5 refresh-from-database SourceDBRefreshReport<n>.XML Importante
Um relatório de saída é diferente do 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 Execução do Console do SSMA (AccessToSQL).
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:
Sl. Não. Comandos e parâmetros 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 e migrate-data.
Indique a extensão de detalhes que você deseja nos relatórios de erros ao usar as configurações do Relatório de Erros:
Sl. Não. Comandos e parâmetros Descrição da saída 1 report-errors="false" Não há detalhes sobre mensagens de erro/aviso/informações. 2 report-errors="true" Mensagens detalhadas de erro/aviso/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 e migrate-data.
Exemplo:
<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"
/>
synchronize-target:
O comando synchronize-target tem 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 pelo nome TargetSynchronizationReport<n>.XML é criado no local especificado, onde <n> é o número de arquivo exclusivo incrementado com um dígito a cada execução do mesmo comando.
Nota: 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="$TargetDB$.dbo"
on-error="fail-script"
report-errors-to="$SynchronizationReports$"
/>
object-name: Especifica o(s) objeto(s) considerado(s) para sincronização (também pode ter nomes de objetos individuais ou um nome de objeto de grupo).
on-error: especifica se os erros de sincronização devem ser especificados como avisos ou erros. Opções disponíveis para on-error:
report-total-as-warning
report-each-as-warning
fail-script
refresh-from-database:
O comando refresh-from-database tem 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 com o nome SourceDBRefreshReport<n>.XML é criado no local especificado, onde <n> é o número de arquivo exclusivo incrementado com um dígito a cada execução do mesmo comando.
Nota: 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="$SourceDatabaseStandard$"
object-type ="Databases"
on-error="fail-script"
report-errors-to="$RefreshDBFolder$\RefreshReport.xml"
/>
object-name: Especifica o(s) objeto(s) considerado(s) para atualização (também pode ter nomes de objetos individuais ou um nome de objeto de grupo).
on-error: especifica se os erros de atualização devem ser especificados como avisos ou erros. Opções disponíveis para on-error:
report-total-as-warning
report-each-as-warning
fail-script