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:

  1. 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).

  2. 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.

  3. 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

Confira também

Execução do console do SSMA (Access)