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 -dbinfouserdb_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.