지정된 규칙 또는 규칙 그룹에 따라 스키마
저장소와 사용자 데이터베이스의 무결성을 검증합니다.
개요
주: 이 명령은 cqdiagnostics.pl 스크립트에서만 실행할 수 있습니다.
이
스크립트에는 명령에서 필요한 모든 매개변수에 대응하는 변수가
들어있습니다. 스크립트를 편집하여 validatedb 명령과
테스트할 데이터베이스에 맞는 값을 지정한 후 스크립트를 실행하십시오. 스크립트는
Rational® ClearQuest®
설치 디렉토리에 설치됩니다. 기본 위치는 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]
설명
validatedb 하위 명령을
사용하면 지정된 규칙이나 규칙 그룹의 세트에 대해 스키마 저장소 또는 사용자 데이터베이스의
무결성을 검증할 수 있습니다. 규칙 파일에는 사용할 수 있는 규칙 및
규칙 그룹이 들어있습니다. 각 규칙은 테스트한 데이터베이스의 무결성을
판별하는 데 사용되는 제한조건을 나타냅니다. 규칙 그룹은 규칙의 콜렉션입니다.
도구는 데이터베이스의 다음 측면에 대한 유효성을 검증합니다.
- 스키마 저장소 구조(테이블, 열, 색인).
- 데이터 무결성. 명령은 데이터베이스에 입력되는 모든 데이터가
스키마 저장소의 Rational ClearQuest 데이터 코드 페이지와 동일한
코드 페이지에서 온 것인지 확인합니다.
- 사용자 데이터베이스 구조(테이블, 열, 색인).
규칙 심각도
validatedb
명령은 다음 심각도 레벨에 따라 규칙 위반사항을 보고합니다.
- [심각도 = FATAL_ERROR] 도구가 위반사항을 감지하고 테스트가 중단됩니다.
이 위반사항으로 인해 대부분의 후속규칙이
실패합니다. 콘솔은 심각도 레벨과 해당 위반사항을 표시하고
오류가 해결될 때까지 모든 추가 테스트를 정지시킵니다. 해당 결과는 또한
로그 파일에 인쇄되며 관련 지시사항이 있는 경우 결과 파일에도 인쇄됩니다.
- [심각도 = ERROR] 도구가 위반사항을 감지하지만 그로 인해 테스트가
중단되지는 않습니다. 콘솔은 심각도 레벨과 해당 위반사항을 표시하고
테스트를 계속 수행합니다. 해당 결과는
또한 로그 파일에 인쇄되며 관련 지시사항이 있는 경우 결과 파일에도 인쇄됩니다.
- [심각도 = WARNING] 도구가 잠재적인 위반사항을 감지합니다. 콘솔은
심각도 레벨과 해당 위반사항을 표시하고 테스트를 계속 수행합니다. 해당 결과는
또한 로그 파일에 인쇄되며 관련 지시사항이 있는 경우 결과 파일에도 인쇄됩니다.
- [심각도 = RECOMMENDATION] 도구가 위반사항 또는 잠재적 위반사항에 대한
권장사항을 제공하고 테스트를 계속합니다. 해당 결과는
또한 로그 파일에 인쇄되며 관련 지시사항이 있는 경우 결과 파일에도 인쇄됩니다.
- [심각도 = INFORMATIONAL] 콘솔이 규칙 정의에 지정된 정보를
표시합니다. 이 위반사항에는 규칙 정의에 따라 수동
개입이 필요합니다. 테스트가 계속 수행되며 해당 결과는 로그 파일에
인쇄됩니다. 관련 지시사항이 있는 경우 결과 파일에도 인쇄됩니다.
validatedb 결과물
유틸리티는
다음 정보를 제공합니다.
- 입력 매개변수 요약
- 규칙 파일의 경로
- 결과 파일의 경로(지정된 경우)
- 로그 파일의 경로
- 사용자가 제공한 데이터베이스 정보의 요약
- 각 규칙에 대한 실행 진행 상태 및 결과 상태
- 실행 상태. 실행 상태는 현재 실행
중인 규칙, 호출한 규칙 중에서 실행된
규칙의 수와 규칙 위반 횟수를 나타냅니다.
- 결과 상태. 데이터베이스에서 규칙을 위반하지 않는 경우 콘솔은
규칙 실행을 완료로 확인합니다. 데이터베이스가 규칙을 위반하는
경우 콘솔은 위반 심각도와 해당 위반사항을 제공합니다.
- 실행 종료 후 결과 요약. 실행 요약은
정보 요약 섹션과 결과 요약 섹션으로 구성됩니다.
- 정보 요약. 이 섹션에는 INFORMATIONAL
심각도 레벨의 모든 규칙 위반사항이 기록됩니다.
- 결과 요약. 결과 요약은 다음과 같은 정보를 제공합니다.
- 호출된 규칙 수
- 실행된 규칙 수
- 완료된 규칙 수
- 각 심각도 레벨별 위반 횟수
이 결과는 지정된 로그 파일 및 결과 파일에 기록됩니다.
옵션 및 인수
- -rulefile
- 데이터베이스를 테스트하기 위한 규칙을 포함하는 규칙 파일을 지정합니다.
이 옵션은 규칙 파일의 모든 규칙에 대해 데이터베이스의 유효성을 검증합니다. 아래의 예제를 참조하십시오.
- -logfile
- 명령 실행 중에 발생하는 모든
이벤트에 대한 세부 레코드를 제공합니다. 아래의 예제를 참조하십시오.
- -resultsfile
- 테스트 결과를 제공합니다. 결과 파일은 로그 파일이
제공하는 세부 이벤트 정보를 제공하지 않습니다. 데이터베이스가
지정된 규칙을 위반하지 않는 경우 결과 파일은 규칙 실행이 완료된
것으로 나타냅니다. 데이터베이스가 규칙을 위반하는
경우 결과 파일은 위반 심각도와 해당 위반사항을 제공합니다. 아래의 예제를 참조하십시오.
- -rulenames
- 테스트할 규칙 파일에서 규칙 이름을 지정합니다. 하나의 명령에 여러
규칙을 지정하려면 각 규칙 이름 사이에 하나의 공백을 삽입하십시오.
아래의 예제를 참조하십시오.
- -rulegroups
- 규칙 파일에서 테스트할 규칙 그룹을 지정합니다. 이 옵션을 사용하면 각 규칙을
개별적으로 호출하지 않고 데이터베이스에 대해 여러 규칙을 테스트할 수 있습니다.
하나의 명령에 여러 규칙 그룹을 지정하려면 각 규칙 그룹 이름
사이에 하나의 공백을 삽입하십시오. 아래의 예제를 참조하십시오.
- -allrules
- 규칙 파일의 모든 규칙을 테스트합니다.
- -dbinfoschemarepo
- 유효성을 검증할 스키마 저장소를 지정합니다. 이 옵션은 스키마
저장소를 찾고 액세스하는 데 필요한 정보를 제공합니다. -dbinfoschemarepo 매개변수에 대해서는
표 1을 참조하십시오.
- -dbinfouser
- 유효성을 검증할 사용자 데이터베이스를 지정합니다. -dbinfouser 매개변수에 대해서는 표 1을 참조하십시오.
표 1. -dbinfoschemarepo 및 -dbinfouser 옵션의 매개변수db_vendor |
server [:port] |
database |
user_login |
user_password |
connect_options |
SQL_SERVER |
서버 시스템 이름 또는 IP |
데이터베이스 이름 |
로그인 이름 |
로그인 비밀번호 |
없음 |
ORACLE |
서버 시스템 이름 또는 IP |
SID |
로그인 이름 |
로그인 비밀번호 |
Oracle 연결 옵션 |
MS_ACCESS |
데이터베이스의 실제 위치 |
없음 |
없음 |
없음 |
없음 |
DB2® |
서버 시스템 또는 IP |
데이터베이스 이름 |
로그인 이름 |
로그인 이름 |
없음 |
- -validateuserdbonly
- 사용자 데이터베이스만 유효성 검증하도록 지정합니다.
- -locale
- 출력 시 사용할 언어를 지정합니다. 결과 파일 및 콘솔은
대체 언어를 제공합니다. 로그 파일은 영어로만 작성됩니다.
예제
validatedb 명령을 실행하려면
사용자가
cquest–home–dir\diagnostic\ 위치에 있어야 합니다.
주: 이 명령은 cqdiagnostics.pl 스크립트에서만 실행할 수 있습니다.