validatedb

Valida a integridade de um repositório de esquemas e um banco de dados do usuário com base nas regras ou nos grupos de regras especificados.

Sinopse

Nota: Este comando só pode ser executado a partir do script cqdiagnostics.pl. Este script contém variáveis que correspondem a todos os parâmetros requeridos pelo comando. Edite o script para especificar o comando validatedb e os valores para o(s) banco(s) de dados a ser(em) testado(s) e execute o script. O script é instalado no diretório de instalação do Rational ClearQuest. O local padrão é cquest–home–dir\diagnostic\cqdiagnostics.pl.
validatedb –rulefile rule file -logfile log file [–resultsfile results file ] [ –rulenames rule names... | –rulegroups rule groups... | –allrules ] -dbinfoschemarepo db_vendor server [ :port_no ] database user_login user_password connect_options [ -dbinfouser cqdb_logicalname db_vendor server [ :port_no ] database user_login user_password connect_options ] [ –validateuserdbonly ] [–locale locale_name]

Descrição

Utilize o subcomando validatedb para validar a integridade de um repositório de esquemas ou banco de dados do usuário com um conjunto de regras especificadas ou grupos de regras. Um arquivo de regras contém as regras e grupos de regras que podem ser utilizados. Cada regra representa uma restrição utilizada para determinar a integridade do banco de dados testado. Um grupo de regras é uma coleta de regras. A ferramenta valida os seguintes aspectos de um banco de dados:
  • Estrutura de um repositório de esquemas (tabelas, colunas, índices).
  • Integridade dos dados. O comando verifica se todos os dados digitados no banco de dados são da mesma página de códigos que a página de códigos de dados do Rational ClearQuest do repositório de esquema.
  • Estrutura de um banco de dados do usuário (tabelas, colunas, índices).

Gravidade da Regra

O comando validatedb relata violações de regras, de acordo com os seguintes níveis de gravidade:
  • [Severity = FATAL_ERROR] A ferramenta encontra uma violação que a impede de continuar o teste porque a violação causaria a falha da maioria das regras subseqüentes. O console exibe o nível de gravidade e a violação e trava todo o teste até que o erro seja resolvido. Os resultados também são impressos no arquivo de log e em um arquivo de resultados, se for indicado.
  • [Severity = ERROR] A ferramenta encontra uma violação, mas a violação não faz com que a ferramenta interrompa o teste. O console exibe o nível da gravidade e a violação e prossegue com o teste. Os resultados também são impressos no arquivo de log e em um arquivo de resultados, se for indicado.
  • [Severity = WARNING] A ferramenta encontra uma possível violação. O console exibe o nível de gravidade e a violação, e continua o teste. Os resultados também são impressos no arquivo de log e em um arquivo de resultados, se for indicado.
  • [Severity = RECOMMENDATION] A ferramenta fornece uma recomendação para uma violação ou violação em potencial e prossegue com o teste. Os resultados também são impressos no arquivo de log e em um arquivo de resultados, se for indicado.
  • [Severity = INFORMATIONAL] O console exibe informações especificadas pela definição de regras. Essas violações requerem intervenção manual, de acordo com a definição da regra. O teste continua e os resultados são impressos no arquivo de log e no arquivo de resultados, se for indicado.

Saída de validatedb

O utilitário fornece as seguintes informações:
  • Um resumo dos parâmetros de entrada
    • O caminho para o arquivo de regras.
    • O caminho para o arquivo de resultados (se especificado).
    • O caminho para o arquivo de log.
    • O resumo das informações do banco de dados fornecidas.
  • O status do progresso e do resultado da execução de cada regra.
    • Status da Execução. O status da execução indica qual regra está sendo executada no momento, o número de regras executadas fora do número de regras chamadas e todas as violações de regras ocorridas.
    • Status do Resultado. Se o banco de dados não violar uma regra, o console confirmará a execução de uma regra como concluída. Se o banco de dados violar uma regra, o console fornecerá a gravidade da violação e a violação.
  • Um resumo dos resultados após o término da execução. O resumo da execução tem duas seções, o resumo informativo e o resumo de resultados.
    • Resumo das Informações. Todas as violações de regras do nível de gravidade INFORMATIONAL são gravadas nesta seção.
    • Resumo de Resultados. O resumo dos resultados fornece estas informações:
      • O número de regras chamadas.
      • O número de regras executadas.
      • O número de regras concluídas.
      • O número de violações de cada nível de gravidade.

Esta saída será gravada no arquivo de log e no arquivo de resultados, se for especificado.

Opções e Argumentos

-rulefile
Especifica o arquivo de regras que contém as regras a serem testadas em um banco de dados. Esta opção valida o banco de dados em relação a todas as regras do arquivo de regras. Consulte os Exemplos abaixo.
-logfile
Fornece um registro detalhado de todos os eventos ocorridos durante a execução de um comando. Consulte os Exemplos abaixo.
-resultsfile
Fornece os resultados do teste. O arquivo de resultados não fornece as informações de eventos detalhadas que o arquivo de log fornece. Se o banco de dados não violar a regra especificada, o arquivo de resultados indicará que a execução da regra foi concluída. Se o banco de dados violar a regra, o arquivo de resultados fornecerá a gravidade da violação e a violação. Consulte os Exemplos abaixo.
-rulenames
Especifica o nome de uma regra dentro do arquivo de regras a ser testado. Para especificar várias regras em um comando, insira um espaço vazio entre cada nome de regra. Consulte os Exemplos abaixo.
-rulegroups
Especifica um grupo de regras dentro do arquivo de regras a ser testado. Utilize esta opção para testar várias regras em relação a um banco de dados, sem precisar chamar cada regra individualmente. Para especificar vários grupos de regras em um comando, insira um espaço entre cada nome do grupo de regras. Consulte os Exemplos abaixo.
-allrules
Testa todas as regras do arquivo de regras.
-dbinfoschemarepo
Especifica o repositório de esquemas a ser validado. Esta opção fornece as informações necessárias para localizar e acessar o repositório de esquemas. Consulte Tabela 1 para obter os parâmetros de -dbinfoschemarepo.
-dbinfouser
Especifica o banco de dados do usuário para validação. Consulte Tabela 1 para obter os parâmetros de -dbinfouser.
Tabela 1. Parâmetros para as opções -dbinfoschemarepo e -dbinfouser
db_vendor servidor [:port] banco de dados user_login user_password connect_options
SQL_SERVER Nome ou IP da máquina servidor nome do banco de dados nome de login senha de login Nenhum
ORACLE Nome ou IP da máquina servidor SID nome de login senha de login opções de conexão Oracle
MS_ACCESS Local físico do banco de dados Nenhum Nenhum Nenhum Nenhum
DB2 Máquina ou IP do servidor nome do banco de dados nome de login nome de login Nenhum
-validateuserdbonly
Especifica para validação somente o banco de dados do usuário.
-locale
Especifica qual idioma deverá ser utilizado na saída. O arquivo de resultados e o console oferecem idiomas alternativos. O arquivo de log é gravado somente em inglês.

Exemplos

Para executar o comando validatedb, é necessário estar no seguinte local: cquest–home–dir\diagnostic\.
Nota: Este comando só pode ser executado a partir do script cqdiagnostics.pl.

Feedback