validatedb

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 -dbinfouser
proveedor_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.

Comentarios