Partilhar via

Gerar relatórios (AccessToSQL)

Os relatórios de certas atividades realizadas usando comandos são gerados na Consola SSMA ao nível da árvore de objetos.

Gerar relatórios

Use o seguinte procedimento para gerar relatórios:

  1. Especifique o write-summary-report-to parâmetro. O relatório relacionado é armazenado como nome do ficheiro (se especificado) ou na pasta que especificar. O nome do ficheiro é predefinido por sistema, como mencionado na tabela seguinte, onde <n> é o número único do ficheiro que incrementa com um dígito a cada execução do mesmo comando.

    Os relatórios referem-se aos comandos da seguinte forma:

    Número da ranhura Command 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 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 as opções de comandos para relatórios de saída (dos slots números 2 a 4 mencionados anteriormente), consulte a secção Executar a Consola SSMA.

  2. Indique o grau de detalhe que deseja no relatório de saída usando as definições de Verbosidade do Relatório:

    Número da ranhura 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 estado resumido e detalhado para cada atividade.

    Observação

    As definições de verbosidade do relatório especificadas anteriormente aplicam-se aos comandos gerar o relatório de avaliação, converter o esquema, migrar os dados.

  3. Indique o grau de detalhe que pretende nos relatórios de erro usando as definições de Relatórios de Erros:

    Número da ranhura Comando e parâmetro Descrição da Saída
    1 report-errors="false" Sem detalhes sobre mensagens de erro/aviso/informação.
    2 report-errors="true" Mensagens detalhadas de erro/aviso/informação.

    Observação

    As Definições de Relatórios de Erros especificadas anteriormente são aplicáveis a comandos gerar-relatório-avaliação, converter-esquema, migrar-dados.

Example

<generate-assessment-report
    object-name="testschema"
    object-type="Schemas"
    verbose="yes"
    report-errors="yes"
    write-summary-report-to="$AssessmentFolder$\Report1.xml"
    assessment-report-folder="$AssessmentFolder$\assessment_report"
    assessment-report-overwrite="true"
/>

sincronizar-alvo

O comando synchronize-target tem report-errors-to um parâmetro que especifica a localização do relatório de erro para a operação de sincronização. Depois, é criado um ficheiro pelo nome TargetSynchronizationReport<n>.xml na localização especificada, onde <n> é o número único do ficheiro que incrementa com um dígito a cada execução do mesmo comando.

Se o caminho da pasta for indicado, então report-errors-to o parâmetro torna-se um atributo opcional para o comando synchronize-target.

O exemplo seguinte sincroniza toda a base de dados com todos os atributos:

<synchronize-target
    object-name="$TargetDB$.dbo"
    on-error="fail-script"
    report-errors-to="$SynchronizationReports$"
/>

object-name: Especifica os objetos considerados para sincronização (Também pode ter nomes individuais de objetos 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:

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

atualizar a partir da base de dados

O comando refresh-from-database tem report-errors-to um parâmetro que especifica a localização do relatório de erro para a operação de atualização. Depois, é criado um ficheiro pelo nome SourceDBRefreshReport<n>.xml na localização especificada, onde <n> é o número único do ficheiro que incrementa com um dígito a cada execução do mesmo comando.

Se o caminho da pasta for indicado, então report-errors-to o parâmetro torna-se um atributo opcional para o comando synchronize-target.

O exemplo seguinte atualiza todo o esquema com todos os atributos:

<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 (Também pode ter nomes individuais de objetos 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:

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

Conteúdo relacionado

  • Last updated on