Geração de relatórios (OracleToSQL)

  • Artigo

Os relatórios de determinadas atividades executadas usando comandos são gerados no Console do SSMA no nível da árvore de objetos.

Para gerar os relatórios, use o seguinte procedimento:

  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 é 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º. 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 do Relatório de avaliação. O primeiro é um relatório sobre o desempenho de um comando executado, enquanto o segundo é um relatório XML para consumo programático.

    Para obter as opções de comando para relatórios de saída (do Sl. Nº 2-4 acima), consulte a seção Executando o Console do SSMA (OracleToSQL).

  2. Indique a extensão de detalhes desejada no relatório de saída usando as configurações de detalhamento do Relatório:

    Sl. Nº. 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.

    Nota

    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.

  3. Indique a extensão de detalhes que você deseja nos relatórios de erros usando as configurações de Relatório de Erros:

    Sl. Nº. 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.

    Nota

    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 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="<object-name>"  
  
   on-error="report-total-as-warning/report-each-as-warning/fail-script"  
  
   report-errors-to="<file-name/folder-name>"/>

object-name: especifica o(s) objeto(s) considerado(s) para sincronização (Ele também pode ter nomes de objeto individual 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="<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 o(s) objeto(s) considerado(s) para atualização (também pode ter nomes de objeto individual 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

Confira também

Executando o console do SSMA (Oracle)