Compartilhar via


Geração de relatórios (OracleToSQL)

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 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 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ã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, 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ã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, migrate-data, convert-sql-statement.

Exemplo:

<generate-assessment-report  
  
   object-name="<object-name>"  
  
   object-type="<object-type>"  
  
   verbose="<true/false>"  
  
   report-errors="<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 (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="<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 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

Confira também

Executando o console do SSMA (Oracle)