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.
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 synchronize-target TargetSynchronizationReport<n>.XML 5 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 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:
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 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:
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 e migrate-data.
Exemplo:
<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:
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="$TargetDB$.dbo"
on-error="fail-script"
report-errors-to="$SynchronizationReports$"
/>
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="$SourceDatabaseStandard$"
object-type ="Databases"
on-error="fail-script"
report-errors-to="$RefreshDBFolder$\RefreshReport.xml"
/>
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