Compartilhar via

Gerar relatórios (Db2ToSQL)

  • Artigo

Os relatórios de determinadas atividades executadas usando comandos são gerados no Console do SSMA (Assistente de Migração do SQL Server) no nível da árvore de objetos.

Gerar um relatório

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

  1. Especifique o write-summary-report-to parâmetro. 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 a seguir, onde <n> é o número de arquivo exclusivo que é incrementado com um dígito a cada execução do mesmo comando.

    Os relatórios estão relacionados aos comandos da seguinte forma:

    Número do slot 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 último é um relatório XML para consumo programático.

    Para obter as opções de comando para relatórios de saída (do Slot número 2 - 4 na tabela anterior), consulte a seção Executar o console do SSMA.

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

    Número do slot 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 se aplicam aos generate-assessment-reportcomandos , convert-schema, migrate-data, e 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:

    Número do slot Comando e parâmetro Descrição da saída
    1 report-errors="false" Não há detalhes sobre mensagens de erro, aviso ou informações.
    2 report-errors="true" Mensagens detalhadas de erro, aviso ou informações.

    Observação

    As configurações do Relatório de Erros se aplicam aos generate-assessment-reportcomandos , convert-schema, migrate-data, e 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>"/>

Comandos de relatório

synchronize-target

O comando synchronize-target tem report-errors-to parâmetro, que especifica o local do relatório de erros para a operação de sincronização. Em seguida, um arquivo por nome TargetSynchronizationReport<n>.xml é criado no local especificado, onde <n> é o número de 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 report-errors-to parâmetro se tornará um atributo opcional para o comando synchronize-target.

O exemplo a seguir sincroniza todo o banco de dados de destino com todos os atributos.

<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 os objetos considerados para sincronização. Ele 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 erro. 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 report-errors-to parâmetro, que especifica o local do relatório de erros para a operação de atualização. Em seguida, um arquivo por nome SourceDBRefreshReport<n>.xml é criado no local especificado, onde <n> é o número de arquivo exclusivo que é incrementado com um dígito a cada execução do mesmo comando.

Se o caminho da pasta for fornecido, o report-errors-to parâmetro se tornará um atributo opcional para o comando synchronize-target.

O exemplo a seguir atualiza todo o esquema com todos os atributos.

<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 os objetos considerados para atualização. Ele 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 erro. Opções disponíveis para on-error:

    • report-total-as-warning
    • report-each-as-warning
    • fail-script

Conteúdo relacionado