Valida la integridad de un repositorio de esquemas y la base de datos de un usuario en función de las reglas o los grupos de reglas que se hayan definido.
Sinopsis
Nota: Este mandato únicamente puede ejecutarse desde el script cqdiagnostics.pl.
Este script contiene variables que corresponden a todos los parámetros que requiere el mandato. Edite el script para especificar el mandato validatedb y los valores para las bases de datos que deben probarse y para ejecutar el script. El script se instala en el directorio de instalación de Rational ClearQuest. La ubicación predeterminada es dir-inicio-cquest\diagnostic\cqdiagnostics.pl.
-
- validatedb –rulefile archivo_reglas -logfile log file [–resultsfile archivo_resultados ] [ –rulenames nombres regla... | –rulegroups grupos reglas... | –allrules ] -dbinfoschemarepo proveedor_bd servidor [ :núm_puerto ] basedatos inicio_sesión_usuario contraseña_usuario opciones_conexión [ -dbinfouser nombre_lógico_bd_cq proveedor_bd servidor [ :núm_puerto ] basedatos inicio_sesión_usuario contraseña_usuario opciones_conexión ]
[ –validateuserdbonly ] [–locale nombre_local]
Descripción
Utilice el submandato
validatedb para validar la integridad de un repositorio de esquemas o una base de datos del usuario ante un conjunto de reglas o grupos de reglas que se hayan especificado. Un conjunto de reglas contiene las reglas y los grupos de reglas que pueden utilizarse. Cada regla representa una restricción utilizada para determinar la integridad de la base de datos probada. Un grupo de reglas es una colección de reglas.
La herramienta valida los aspectos siguientes de una base de datos:
- La estructura de un repositorio de esquemas (tablas, columnas, índices).
- La integridad de los datos. El mandato verifica que todos los datos introducidos en la base de datos tienen la misma página de códigos que los datos de Rational ClearQuest del repositorio de esquemas.
- La estructura de una base de datos del usuario (tablas, columnas, índices).
Gravedad de la regla
El mandato
validatedb informa acerca de infracciones de regla según los niveles de gravedad siguientes:
- [Severity = FATAL_ERROR] La herramienta detecta una infracción que evita que se siga probando porque podría provocar que las reglas inmediatamente subsiguientes fallen. La consola muestra el nivel de gravedad y la infracción y detiene todas las pruebas adicionales hasta que se resuelve el error. Los resultados se imprimen también en el archivo de registro, y en un archivo de resultados, si son derivados al mismo.
- [Severity = ERROR] La herramienta detecta una infracción, pero no provoca que la herramienta deje de ejecutar la prueba. La consola muestra el nivel de gravedad y la infracción y sigue con la ejecución de la prueba. Los resultados se imprimen también en el archivo de registro, y en un archivo de resultados, si son derivados al mismo.
- [Severity = WARNING] La herramienta detecta una infracción potencial. La consola muestra el nivel de gravedad y la infracción y sigue con la ejecución de la prueba. Los resultados se imprimen también en el archivo de registro, y en un archivo de resultados, si son derivados al mismo.
- [Severity = RECOMMENDATION] La herramienta proporciona una recomendación acerca de una infracción o una infracción potencial y sigue con la ejecución de la prueba. Los resultados se imprimen también en el archivo de registro, y en un archivo de resultados, si son derivados al mismo.
- [Severity = INFORMATIONAL] La consola muestra la información que especifica la definición de regla. Estas infracciones requieren intervención manual en función de la definición de la regla. La prueba sigue ejecutándose y los resultados se imprimen en el archivo de registro, y en un archivo de resultados, si son derivados al mismo.
Salida de validatedb
El programa de utilidad proporciona la información siguiente:
- Un resumen de los parámetros de entrada
- La vía de acceso al archivo de reglas.
- La vía de acceso al archivo de resultados (si se especifica).
- La vía de acceso al archivo de registro.
- Un resumen de la información de la base de datos proporcionada.
- El progreso de la ejecución y el estado del resultado de cada regla.
- El estado de ejecución. El estado de ejecución indica la regla que se está ejecutando actualmente, el número de reglas ejecutadas, sin contar el número de reglas invocadas, y el número de infracciones que se ha producido.
- El estado del resultado. Si la base de datos no infringe una regla, la consola confirma que se ha completado la ejecución de una regla. Si la base de datos viola una regla, la consola proporciona la gravedad de la infracción y la infracción.
- Un resumen de los resultados tras finalizar la ejecución. El resumen de la ejecución tiene dos secciones, el resumen informativo y el resumen de resultados.
- El resumen informativo. Todas las infracciones de reglas con el nivel de gravedad INFORMATIONAL
se escriben en esta sección.
- El resumen de los resultados. El resumen de los resultados proporciona esta información:
- El número de reglas invocadas.
- El número de reglas ejecutadas.
- El número de reglas completadas.
- El número de infracciones por cada nivel de gravedad.
Esta salida se escribe en el archivo de registro, y en un archivo de resultados, si se ha especificado.
Opciones y argumentos
- -rulefile
- Especifica el archivo de reglas que contiene las reglas para probar ante una base de datos.
Esta opción valida la base de datos ante todas las reglas del archivo de reglas.
Consulte los Ejemplos, a continuación.
- -logfile
- Proporciona una registro detallado de todos los sucesos que se producen durante la ejecución de un mandato. Consulte los Ejemplos, a continuación.
- -resultsfile
- Proporciona los resultados de la prueba. El archivo de resultados no proporciona una información tan detallada del suceso como la proporcionada por el archivo de registro. Si la base de datos no infringe la regla especificada, el archivo de resultados indica que la ejecución de la regla se ha completado. Si la base de datos infringe la regla, el archivo de resultados proporciona la gravedad de la infracción y la infracción. Consulte los Ejemplos, a continuación.
- -rulenames
- Especifica el nombre de una regla dentro del archivo de reglas que se probará. Para especificar varias reglas en un mandato, inserte un espacio vacío entre cada nombre de regla.
Consulte los Ejemplos, a continuación.
- -rulegroups
- Especifica un grupo de reglas dentro del archivo de reglas que se probará. Utilice esta opción para probar diversas reglas ante una base de datos sin tener que llamar individualmente a cada regla.
Para especificar varios grupos de reglas en un mandato, inserte un espacio vacío entre cada nombre de grupo de reglas. Consulte los Ejemplos, a continuación.
- -allrules
- Prueba todas las reglas del archivo de reglas.
- -dbinfoschemarepo
- Especifica el repositorio de esquemas que se validará. Esta opción proporciona la información necesaria para localizar el repositorio de esquemas y acceder al mismo. Consulte Tabla 1 para obtener información acerca de los parámetros de -dbinfoschemarepo.
- -dbinfouser
- Especifica la base de datos del usuario que se validará. Consulte Tabla 1 para obtener información acerca de los parámetros de -dbinfouser.
Tabla 1. Parámetros para las opciones -dbinfoschemarepo y -dbinfouserproveedor_bd |
servidor [:puerto] |
basedatos |
inicio_sesión_usuario |
contraseña_usuario |
opciones_conexión |
SQL_SERVER |
IP o nombre de la máquina servidor |
nombre de base de datos |
nombre de inicio de sesión |
contraseña de inicio de sesión |
ninguna |
ORACLE |
IP o nombre de la máquina servidor |
SID |
nombre de inicio de sesión |
contraseña de inicio de sesión |
opciones de conexión de Oracle |
MS_ACCESS |
ubicación física de la base de datos |
ninguno |
ninguno |
ninguna |
ninguna |
DB2 |
IP o máquina servidor |
nombre de base de datos |
nombre de inicio de sesión |
nombre de inicio de sesión |
ninguna |
- -validateuserdbonly
- Especifica que se valide exclusivamente la base de datos del usuario.
- -locale
- Especifica el idioma que debe utilizarse para la salida. El archivo de resultados y la consola ofrecen idiomas alternativos. El archivo de registro únicamente se escribe en inglés.
Ejemplos
Para ejecutar el mandato
validatedb debe estar en la ubicación siguiente:
dir-inicio-cquest\diagnostic\.
Nota: Este mandato únicamente puede ejecutarse desde el script cqdiagnostics.pl.