ManageRepository 유틸리티

ManageRepository 유틸리티는 데이터베이스에 저장소를 작성하고 이를 관리합니다. 저장소에는 pureQuery 사용 가능 애플리케이션에서 사용되는 pureQuery 데이터(예: 구성 정보 및 pureQueryXML 데이터)가 포함되어 있습니다. 저장소는 pureQuery 클라이언트 최적화에 사용 가능한 애플리케이션에서 캡처된 SQL 데이터를 저장할 수 있습니다.

저장소 설치를 지원하는 데이터베이스가 사용 가능해야 하며 애플리케이션이 pureQuery 클라이언트 최적화를 사용하도록 구성되어야 합니다. pureQuery 시스템 요구사항은 Optim™ pureQuery Runtime의 시스템 요구사항을 참조하십시오.

다음 절은 ManageRepository 유틸리티에 대해 설명합니다.

다이어그램에서 사용되는 규칙을 이해하려면 구문 다이어그램 읽는 방법을 참조하십시오.

저장소 레벨 조작

저장소 레벨의 ManageRepository 조작에는 데이터베이스에서 저장소 작성 및 제거, 저장소의 유효성 점검 및 저장소 버전 표시가 포함됩니다.

저장소 작성, 저장소 제거 또는 저장소 바인드에 필요한 SQL문을 보려면 -generateScriptOnly 옵션을 사용하십시오. 조작을 수행하지 않고 명령문이 생성됩니다. SQL문을 수정하고 명령문을 발행하는 경우, -verify repository를 사용하여 저장소를 점검할 수 있습니다.

pureQuery 클라이언트 최적화에 사용된 pureQuery 파일의 정보만 포함하는 저장소를 작성하려면 -repositoryType 옵션을 -pureQueryRuntimeOnly 매개변수와 함께 사용하십시오. 저장소는 캡처한 SQL 데이터를 저장하지 않습니다.

저장소 레벨 조작을 위한 ManageRepository 명령의 구문

구문 도표 읽기시각적 구문 도표 생략
    (1)                                             
>>-------java--com.ibm.pdq.tools.ManageRepository--------------->

>--+- -create repository-- -repositoryType--+-pureQueryOnly--------+-+-->
   |                                        '-pureQueryRuntimeOnly-' |   
   |  (2)                                                            |   
   +------- -bind packages-------------------------------------------+   
   +- -verify repository---------------------------------------------+   
   +- -report--+-repositoryData-- -file--file-name-+-----------------+   
   |           '-repositoryVersion-----------------'                 |   
   '- -delete repository--+--------------------+---------------------'   
                          |          .-FALSE-. |                         
                          '- -force--+-TRUE--+-'                         

>--| 연결 정보 |---------------------------------------------------->

>--+-------------------------------------------------+---------->
   |  (3)                                            |   
   '------- -generateScriptOnly--path-to-script-file-'   

>--+--------+--------------------------------------------------><
   '- -help-'   

연결 정보

|-- -repositoryURL--URL-to-repository-database------------------>

>-- -repositoryUsername--user-ID-- -repositoryPassword--password-->

>-- -repositoryDriverClass--driverclass-------------------------|

주:
  1. 임의의 순서로 옵션을 지정할 수 있습니다.
  2. -bind packages 옵션은 정적 SQL을 지원하는 데이터베이스에 대해서만 사용할 수 있습니다.
  3. -generateScriptOnly 옵션은 -report 옵션과 함께 사용할 수 없습니다.

저장소 레벨 조작 옵션에 대한 설명

다음 목록은 지원되는 ManageRepository 옵션 및 변수에 대해 설명합니다.

-create repository
ManageRepository 유틸리티는 연결 정보를 사용하여 데이터베이스 플랫폼 유형을 판별하고 지정된 스키마에 테이블을 작성하는 데 적합한 DDL문을 발행합니다.

데이터가 이 명령에 의해 대체됨을 표시하는 메시지가 표시됩니다. 사용자에게 조치를 취소할 수 있는 옵션이 표시됩니다.

-repositoryType
작성할 저장소 유형을 지정하십시오. 지원되는 저장소 유형은 다음과 같습니다.
  • pureQueryOnly. 기본값입니다. 저장소에 pureQuery 클라이언트 최적화 옵션에 사용되는 pureQuery 파일의 정보, 바인드 옵션, 캡처된 SQL 생성 옵션 및 pureQueryXML 데이터만 포함됩니다.
  • pureQueryRuntimeOnly 저장소에 pureQuery 클라이언트 최적화에 사용되는 pureQuery 파일의 정보만 포함됩니다.

Use the 저장소를 작성하지 않고 저장소를 작성하기 위한 SQL문을 포함하는 SQL 스크립트를 생성하려면 -generateScriptOnly 옵션을 사용하십시오. 스크립트를 검토한 후 스크립트를 실행하여 저장소를 작성할 수 있습니다. SQL문을 수정하고 스크립트를 실행하는 경우, -verify repository를 사용하여 저장소를 점검할 수 있습니다.

-bind packages
정적 SQL을 지원하는 데이터베이스 플랫폼에서 저장소에 대한 액세스를 관리하기 위해 데이터베이스 패키지가 작성되도록 지정합니다. 콜렉션 이름 및 패키지 이름은 유틸리티가 선택하며 사용자가 수정할 수 없습니다.

저장소가 작성된 후 이러한 패키지에 대한 특권을 부여하고 취소하기 위해 ManageRepository 유틸리티 -grant-revoke 옵션이 사용됩니다. 패키지에 대한 액세스 권한 부여에 관한 설명은 런타임 그룹 특권 관리 조작을 참조하십시오.

바인드 조작을 수행하지 않고 스크립트만 생성하려면 -generateScriptOnly 옵션을 사용하십시오.

-report repositoryData | repositoryVersion
저장소에 대한 정보를 표시합니다.
repositoryData -file file-name
저장소의 런타임 그룹 정보를 설명하는 HTML 보고서를 생성합니다. file-name은 보고서가 포함될 파일의 경로 및 파일 이름입니다.
repositoryVersion
저장소의 버전을 리턴합니다.
-verify repository
저장소의 테이블을 점검하여 예상된 컬럼 및 컬럼 유형을 사용하여 테이블이 올바르게 작성되었는지 확인합니다. 또한 저장소에 대한 읽기 및 쓰기 액세스가 올바른지 점검하는 테스트가 수행되어 실행 사용자 ID에 올바른 권한이 있는지 확인합니다.

리턴되는 출력에는 저장소의 다른 구성요소에 대한 정보 및 저장소에 대한 문제점(예: 올바르지 않은 권한 또는 컬럼이 누락된 테이블)을 표시하는 메시지가 포함되어 있습니다.

저장소를 검증하지 않고 SQL 스크립트를 생성하려면 -generateScriptOnly 옵션을 사용하십시오.

-delete repository
저장소에서 사용되는 모든 테이블을 삭제(drop)합니다. 저장소의 모든 데이터가 삭제됩니다.
메시지가 표시되고 사용자에게 데이터베이스 테이블 제거를 확인하는 프롬프트가 표시됩니다.
-force TRUE|FALSE
저장소 제거를 확인하는 부울 값입니다.

메시지를 표시하지 않고 제거를 확인하려면 -force TRUE를 사용하십시오.

저장소를 삭제하지 않고 SQL 스크립트를 생성하려면 -generateScriptOnly 옵션을 사용하십시오.

-generateScriptOnly path-to-script-file
조작을 수행하지 않고 ManageRepository 조작을 수행하기 위한 SQL문을 포함하는 SQL 스크립트를 생성합니다.저장소 데이터베이스에 대한 연결 정보를 지정해야 합니다.

저장소를 작성하기 위한 스크립트에서 일부 오브젝트 이름을 변경하도록 스크립트를 수정할 수 있습니다. 그러나 스키마 이름, 테이블 이름 또는 컬럼 이름은 수정할 수 없습니다.ManageRepository에 대한 작업에 관한 정보는 사용 참고사항의 내용을 참조하십시오.

데이터베이스 관리자는 스크립트를 검토하고 수정한 후 스크립트를 실행하여 저장소를 작성할 수 있습니다. 예를 들어, 데이터베이스 관리자는 스크립트의 SQL문에 테이블 스페이스를 추가할 수 있습니다.

저장소를 작성한 후 -verify repository 옵션을 사용하여 저장소를 점검할 수 있습니다.

-bind packages 옵션의 경우, 콜렉션 이름 및 패키지 이름은 유틸리티가 선택하며 사용자가 수정할 수 없습니다.

-help
요약 사용 정보를 표시합니다.

연결 정보 옵션에 대한 설명

다음 목록은 저장소 데이터베이스에 연결하는 데 필요한 정보에 대해 설명합니다.

-repositoryURL URL- to-repository-database
저장소 데이터베이스에 대한 URL
-repositoryUsername user-ID -repositoryPassword password
데이터베이스에 연결하는 데 사용되는 ID 및 암호
-repositoryDriverClass driverclass
저장소 데이터베이스에 연결하는 데 사용할 JDBC 드라이버 클래스의 완전한 클래스 이름입니다.

런타임 그룹 관리 조작

ManageRepository 런타임 그룹 조작에는 저장소에서 런타임 그룹 및 그룹 버전 작성, 관리 및 제거가 포함됩니다.

런타임 그룹 버전에 저장된 pureQuery 데이터에는 pureQuery 구성 정보, pureQueryXML 데이터 및 선택사항으로 pureQuery 클라이언트 최적화에 사용 가능한 애플리케이션에서 캡처된 SQL 데이터가 포함됩니다.

런타임 그룹 버전에는 또한 런타임 및 그룹의 활성 버전을 식별하기 위해 pureQuery Runtime에서 사용되는 기타 정보도 포함됩니다.

런타임 그룹 관리 조작에 대한 구문

구문 도표 읽기시각적 구문 도표 생략
    (1)                                             
>>-------java--com.ibm.pdq.tools.ManageRepository--------------->

>--+- -create runtimeGroup--+--------------------+------------------------------------------------+-->
   |                        '-| pureQuery 데이터  |-'                                                |   
   +- -update runtimeGroup--+--------------------+------------------------------------------------+   
   |                        '-| pureQuery 데이터  |-'                                                |   
   +- -delete runtimeGroup--+--------------------+------------------------------------------------+   
   |                        |          .-FALSE-. |                                                |   
   |                        '- -force--+-TRUE--+-'                                                |   
   +- -delete incremental-- -inputDirectory--path-to-directory-- -incrementalCapture--file-prefix-+   
   +- -list runtimeGroupVersions------------------------------------------------------------------+   
   +- -activate runtimeGroup----------------------------------------------------------------------+   
   +- -deactivate runtimeGroup--------------------------------------------------------------------+   
   '- -copy runtimeGroup--+---------------------------------+-- -targetVersion--target-version----'   
                          '- -sourceVersion--source-version-'                                         

>-- -runtimeGroupId--GroupID------------------------------------>

    (2)                                   
>-------- -runtimeGroupVersion--version------------------------->

>--+--------------------------------+--+--------+--| 연결 정보 |---><
   '- -contact--contact-information-'  '- -help-'              

pureQuery 데이터 

    (3)                                        
|-------- -inputDirectory--path-to-directory-------------------->

>--+----------------------------------------+------------------->
   '- -pureQueryXml--pureQueryXML-file-name-'   

>--+------------------------------------------+----------------->
   '- -pureQueryProperties--runtime-prop-file-'   

>--+------------------------------------------+----------------->
   '- -optionsFileForConfigure -genProps-file-'   

>--+--------------------------------------+---------------------|
   '- -optionsFileForBind -bindProps-file-'   

연결 정보

|-- -repositoryURL--URL-to-repository-database------------------>

>-- -repositoryUsername--user-ID-- -repositoryPassword--password-->

>-- -repositoryDriverClass--driverclass-------------------------|

주:
  1. 임의의 순서로 옵션을 지정할 수 있습니다.
  2. -runtimeGroupVersion 옵션은 -copy runtimeGroup 옵션과 함께 지정할 수 없습니다.
  3. pureQuery 데이터를 갱신하는 경우, 하나 이상의 파일을 지정해야 합니다.

런타임 그룹 관리 옵션에 대한 설명

다음 목록은 지원되는 ManageRepository 옵션 및 변수에 대해 설명합니다.

-create runtimeGroup
지정된 GroupIDversion을 사용하여 런타임 그룹을 작성합니다.

runtimeGroupId가 저장소에 이미 있는 경우, 오류가 표시됩니다.

런타임 그룹 버전을 작성할 때 기본 pureQuery 설정은 다음과 같습니다.
  • executionMode 특성은 DYNAMIC으로 설정되어 있습니다(동적으로 SQL문 실행).
  • captureMode 특성은 ON으로 설정되어 있습니다(캡처 모드는 증분으로 설정됨).

기본값을 대체하고 다른 특성을 지정하려면 특성 및 해당 값을 포함하는 파일을 지정하십시오.

-update runtimeGroup
지정된 파일의 pureQuery 데이터를 사용하여 런타임 그룹 버전의 데이터를 갱신합니다.
-delete runtimeGroup
저장소에서 런타임 그룹 GroupID를 삭제합니다.
메시지가 표시되고 사용자에게 런타임 그룹 제거를 확인하는 프롬프트가 표시됩니다. 사용자에게 조치를 취소할 수 있는 옵션이 표시됩니다.
-force TRUE|FALSE
TRUE 또는 FALSE를 지정하여 런타임 그룹 제거를 확인합니다. TRUE는 확인하지 않고 런타임 그룹을 삭제합니다. 기본값은 FALSE입니다.

메시지를 표시하지 않고 제거를 확인하려면 -force TRUE 옵션을 사용하십시오.

-delete incremental
런타임 그룹 버전에서 캡처된 SQL 데이터를 삭제합니다. 지정된 캡처된 SQL 파일의 데이터가 저장소 데이터와 비교되며 일치하는 경우 저장소의 캡처된 SQL 데이터가 제거됩니다.

캡처된 SQL 데이터를 런타임 그룹 버전의 pureQueryXML 데이터와 병합한 후 해당 버전의 캡처된 SQL 데이터를 삭제할 수 있습니다.

-inputDirectory path-to-directory
캡처된 SQL 파일을 포함하는 디렉토리의 전체 경로입니다.
-incrementalCapture file-prefix
캡처된 SQL 파일에서 사용되는 접두부입니다.
-list runtimeGroupVersions
런타임 그룹 버전에 대한 정보를 표시합니다.
-activate runtimeGroup
런타임 그룹 버전을 활성화합니다.

pureQuery Runtime은 저장소의 런타임 그룹에 액세스할 때 활성 런타임 그룹 버전의 pureQuery 정보를 사용합니다.

-deactivate runtimeGroup
런타임 그룹을 비활성화합니다.

pureQuery Runtime은 저장소의 런타임 그룹에 액세스할 때 활성 상태가 아닌 런타임 그룹의 pureQuery 정보를 무시합니다.

-copy runtimeGroup
-sourceVersion 옵션으로 지정된 버전의 런타임 그룹 데이터를 -targetVersion 옵션으로 지정된 버전과 이름이 동일한 그룹에 복사합니다.
-sourceVersion source-version
새 런타임 그룹 버전을 작성하는 데 사용되는 런타임 그룹의 기존 버전을 지정합니다.

source-version이 지정되지 않은 경우, 활성 런타임 그룹 버전이 사용됩니다. source-version이 지정되지 않고 활성 런타임 그룹 버전이 없는 경우, 오류가 표시됩니다.

-targetVersion target-version
source-version 런타임 그룹 버전이 복사될 때 작성되는 런타임 그룹 버전을 지정합니다.
-runtimeGroup GroupID
저장소 런타임 그룹 ID를 지정합니다.
-runtimeGroupVersion version
런타임 그룹 버전 이름을 지정합니다. -runtimeGroupVersion 옵션은 -copy runtimeGroup 옵션과 함께 지정할 수 없습니다.
-contact contact-information
런타임 그룹 버전과 함께 저장되는 선택적 연락 정보를 지정하는 문자열입니다.
-help
요약 사용 정보를 표시합니다.

PureQuery 데이터 옵션에 대한 설명

다음 목록은 pureQuery 데이터 옵션에 대해 설명합니다.

-inputDirectory path-to-directory
pureQuery 파일에 대한 디렉토리의 전체 경로입니다.
-pureQueryXml pureQueryXML-file-name
pureQueryXML 파일의 이름입니다.
-pureQueryProperties untime-prop-file-name
pureQuery 런타임 특성 파일의 이름입니다.
-optionsFileForConfigure genProps-file
Configure 유틸리티에서 사용되는 옵션을 포함하는 파일입니다.
-optionsFileForBind bindProps-file
pureQueryXML 파일의 SQL문을 바인드하기 위해 StaticBinder 유틸리티에서 사용하는 옵션을 포함하는 파일입니다.

연결 정보 옵션에 대한 설명

다음 목록은 저장소 데이터베이스에 연결하는 데 필요한 정보에 대해 설명합니다.

-repositoryURL URL- to-repository-database
저장소 데이터베이스에 대한 URL
-repositoryUsername user-ID -repositoryPassword password
데이터베이스에 연결하는 데 사용되는 ID 및 암호
-repositoryDriverClass driverclass
저장소 데이터베이스에 연결하는 데 사용할 JDBC 드라이버 클래스의 완전한 클래스 이름입니다.

런타임 그룹 특권 관리 조작

SQL 캡처 데이터가 저장소 데이터베이스에 저장되면 특권 관리 조작이 수행됩니다. 관리자는 저장소 데이터베이스 테이블을 읽고 쓰는 애플리케이션에 대한 권한을 부여해야 합니다.

특권 관리 조작에 대한 구문

구문 도표 읽기시각적 구문 도표 생략
    (1)                                             
>>-------java--com.ibm.pdq.tools.ManageRepository--------------->

>--+- -revoke-+------------------------------------------------->
   '- -grant--'   

                     .-,----------------.           
                     V                  |           
>----"--grantees--(----authorization-ID-+--) -"----------------->

>-- -privilege--+-tableAccess----------+------------------------>
                |  (2)                 |   
                '-------executePackage-'   

>-- -accessLevel -+-APPLICATION-+--| 연결 정보 |--+--------+-------->
                  '-MANAGER-----'             '- -help-'   

>--+-------------------------------------------+---------------><
   '- -generateScriptOnly--path-to-output-file-'   

연결 정보

|-- -repositoryURL--URL- to-repository-database----------------->

>-- -repositoryUsername--user-ID-- -repositoryPassword--password-->

>-- -repositoryDriverClass--driverclass-------------------------|

주:
  1. 임의의 순서로 옵션을 지정할 수 있습니다.
  2. 정적 SQL을 지원하는 플랫폼에서 -bind packages가 발행된 후 지원되는 옵션은 executePackage 옵션뿐입니다.

저장소 특권 관리 옵션에 대한 설명

다음 목록은 지원되는 ManageRepository 옵션 및 변수에 대해 설명합니다.

-grant
-privilege 옵션으로 지정된 액세스 권한을 grantees 목록에 지정된 사용자에게 부여합니다.
-revoke
grantees 목록에 지정된 사용자에 대해 메타데이터 저장소 테이블에 대한 모든 특권을 취소합니다.

역할 지정은 -revoke 옵션에 필요하지 않습니다.

"grantees(firstID, secondID, ...)"
영향을 받는 데이터베이스 사용자 목록을 지정하는 키워드입니다. grantees 절, 키워드 및 사용자 목록은 큰따옴표 문자(")로 시작하고 끝나야 합니다. 사용자 이름은 쉼표로 구분해야 합니다. 다음 예는 세 개의 권한 부여 ID를 권한 받은 사용자로 나열합니다.
"grantees(test1, test2, user1)" 
authorization-ID
특권이 부여되거나 취소되는 데이터베이스 사용자 ID입니다.

PUBLIC을 ID로 지정할 수 있습니다.

authorization-ID는 데이터베이스 사용자 ID와 동일한 대소문자여야 합니다. 예를 들어, DB2® 사용자 ID가 대문자인 경우, authorization-ID를 대문자로 입력해야 합니다.

-privilege tableAccess|executePackage
권한 부여되는 특권 유형을 지정합니다. 지원되는 특권 값은 다음과 같습니다.
tableAccess
동적 SQL만 지원하는 플랫폼에 대한 특권입니다. 동적 애플리케이션이 기본 메타데이터 저장소 테이블에 액세스할 수 있도록 합니다. tableAccess는 저장소 테이블 자체에 대한 특권이 필요한 동적 SQL 환경을 대상으로 합니다.
executePackage
ManageRepository -bind packages 옵션이 발행된 정적 SQL을 지원하는 플랫폼에 대한 특권입니다. 애플리케이션이 ManageRepository 유틸리티로 작성되고 정적으로 바인드된 SQL문을 사용하여 메타데이터 저장소에 액세스할 수 있도록 보장합니다.
-accessLevel MANAGER|APPLICATION
-accessLevel 옵션에 대해 지원되는 값은 다음과 같습니다.
APPLICATION
APPLICATION 액세스가 지정된 사용자 ID는 pureQueryXML 데이터를 읽고 캡처된 SQL 데이터를 저장하는 데 사용되는 테이블에 쓸 수 있습니다.
MANAGER
MANAGER 액세스는 모든 메타데이터 저장소 테이블에 대한 전체 액세스를 제공합니다. 특권이 사용자 ID의 권한 받은 사용자 목록에 부여됩니다.

저장소 대신 Optim Performance Manager 저장소가 목표로 지정된 경우 MANAGER 액세스 레벨만 사용 가능합니다.

-generateScriptOnly path-to-script-file
조작을 수행하지 않고 ManageRepository 조작을 수행하기 위한 SQL문을 포함하는 SQL 스크립트를 생성합니다.

데이터베이스 관리자는 스크립트를 검토하고 수정한 후 스크립트를 실행하여 저장소를 작성할 수 있습니다. 저장소를 작성한 후 -verify repository 옵션을 사용하여 저장소를 점검할 수 있습니다.

-bind packages 옵션의 경우, 콜렉션 이름 및 패키지 이름은 유틸리티가 선택하며 사용자가 수정할 수 없습니다.

-help
요약 사용 정보를 표시합니다.

연결 정보 옵션에 대한 설명

다음 목록은 저장소 데이터베이스에 연결하는 데 필요한 정보에 대해 설명합니다.

-repositoryURL URL- to-repository-database
저장소 데이터베이스에 대한 URL
-repositoryUsername user-ID -repositoryPassword password
데이터베이스에 연결하는 데 사용되는 ID 및 암호
-repositoryDriverClass driverclass
저장소 데이터베이스에 연결하는 데 사용할 JDBC 드라이버 클래스의 완전한 클래스 이름입니다.

추출, 익스포트 및 임포트 조작

증분 캡처 세트를 사용하여 pureQuery 클라이언트 옵티마이저는 새 SQL문을 계속 캡처하고 사용하지 않는 SQL문을 제거할 수 있도록 SQL 활동을 기록합니다. pureQuery 런타임 특성 파일의 설정에 따라 캡처된 SQL 데이터를 pureQueryXML이 저장된 저장소와 동일한 저장소 또는 다른 저장소에 저장할 수 있습니다. 일단 캡처되면 새 pureQueryXML을 업로드할 수 있도록 캡처된 SQL 데이터를 pureQueryXML과 병합할 수 있습니다. 단계는 다음으로 구성됩니다.
  1. 증분 데이터를 추출합니다.
  2. Merge 유틸리티를 사용하여 캡처된 SQL 파일과 pureQueryXML 파일을 결합합니다.
  3. Configure 유틸리티를 사용하여 갱신된 pureQueryXML 파일을 구성합니다.
  4. 선택사항으로 StaticBind 유틸리티를 사용하여 pureQueryXML 파일에 있는 명령문 세트에서 데이터베이스에 SQL문 패키지를 작성하고 이를 데이터베이스에서 바인드합니다.
  5. 새 데이터를 사용하여 런타임 그룹을 갱신합니다.

데이터 익스포트, 추출 및 임포트 조작에 대한 구문

구문 도표 읽기시각적 구문 도표 생략
    (1)                                             
>>-------java--com.ibm.pdq.tools.ManageRepository--------------->

>--+- -export data-- -file--path-to-zip-file-name-+------------->
   +- -extract runtimeGroup--| pureQuery 데이터  |---+   
   '- -import data-- -file--path-to-zip-file-name-'   

>-- -runtimeGroupId--group-ID----------------------------------->

>-- -runtimeGroupVersion--version-ID--| 연결 정보 |----------------->

>--+-------------------------+--+--------+---------------------><
   |  (2)                    |  '- -help-'   
   '-------| 캡처된 SQL 연결 정보 |-'               

pureQuery 데이터 

    (3)                                         
|-------- -outputDirectory--path-to-directory------------------->

>--+----------------------------------------+------------------->
   '- -pureQueryXml--pureQueryXML-file-name-'   

>--+------------------------------------------+----------------->
   '- -pureQueryProperties--runtime-prop-file-'   

>--+------------------------------------------+----------------->
   '- -optionsFileForConfigure--genProps-file-'   

>--+--------------------------------------+--------------------->
   '- -optionsFileForBind -bindProps-file-'   

>--+------------------------------+-----------------------------|
   '- -incrementalCapture--prefix-'   

연결 정보

|-- -repositoryURL--repository-database-URL--------------------->

>-- -repositoryUsername--user-ID-- -repositoryPassword--password-->

>-- -repositoryDriverClass--driverclass-------------------------|

캡처된 SQL 연결 정보

|-- -incrementalRepositoryURL--repository-database-URL---------->

>-- -incrementalRepositoryUsername--user-ID-- -incrementalRepositoryPassword--password-->

>-- -incrementalRepositoryDriverClass--driverclass--------------|

주:
  1. 임의의 순서로 옵션을 지정할 수 있습니다.
  2. -extract runtimeGroup 옵션에만 사용됩니다. 캡처된 SQL 데이터가 다른 pureQuery 데이터와 독립된 저장소에 상주하는 경우 캡처된 SQL 데이터 추출에 대한 정보를 지정하십시오.
  3. pureQuery 데이터를 갱신하는 경우, 하나 이상의 파일을 지정해야 합니다.

데이터 익스포트 및 추출 옵션에 대한 설명

다음 목록은 지원되는 ManageRepository 옵션 및 변수에 대해 설명합니다.

-export data
모든 런타임 그룹 버전의 pureQuery 데이터를 zip 파일에 익스포트합니다. 데이터를 임포트할 때 zip 파일을 소스로 사용할 수 있습니다.
-file path-to-zip-file-name
익스포트된 런타임 그룹 pureQuery 데이터를 포함할 zip 파일의 전체 경로 및 파일 이름입니다.
-extract runtimeGroup
지정된 런타임 그룹 버전의 모든 또는 일부 pureQuery 데이터를 하나 이상의 파일에 추출합니다. pureQuery 데이터의 유형이 런타임 그룹 버전에서 지정된 파일로 추출됩니다.
-import data
저장소에서 pureQuery 데이터를 익스포트하여 작성된 zip 파일에서 pureQuery 데이터를 임포트합니다.

데이터가 ODS 익스포트 UI를 통해 익스포트되고 둘 이상의 pureQuery 프로젝트가 익스포트되도록 선택된 경우, 마지막 프로젝트의 pureQuery 데이터만 -runtimeGroupId 옵션으로 지정된 런타임 그룹에 임포트됩니다.

-file path-to-zip-file-name
익스포트 데이터를 포함하는 zip 파일의 경로 및 파일 이름을 지정합니다. 이 파일은 저장소 런타임 그룹 버전에서 pureQuery 데이터를 익스포트하거나 저장소 런타임 그룹 버전에 pureQuery 데이터를 임포트하는 데 사용됩니다.
-runtimeGroupId GroupID
저장소 런타임 그룹 ID를 지정합니다.
-runtimeGroupVersion version
런타임 그룹 버전 ID를 지정합니다.
-help
요약 사용 정보를 표시합니다.

PureQuery 데이터 옵션에 대한 설명

다음 목록은 pureQuery 데이터 옵션에 대해 설명합니다.

-outputDirectory path-to-directory
pureQuery 파일에 대한 디렉토리의 전체 경로를 지정합니다.
-pureQueryXml pureQueryXML-file-name
pureQueryXML 파일의 이름을 지정합니다.
-pureQueryProperties untime-prop-file-name
pureQuery 런타임 특성 파일의 이름을 지정합니다.
-optionsFileForConfigure genProps-file
SQL 캡처 파일을 생성하는 데 사용되는 pureQuery 특성을 포함하는 파일을 지정합니다.
-optionsFileForBind bindProps-file
pureQueryXML 파일의 SQL문을 바인드하는 데 사용되는 pureQuery 특성을 포함하는 파일을 지정합니다.
-incrementalCapture prefix
캡처된 SQL 데이터 세트를 파일에 익스포트할 때 사용되는 파일 접두부를 지정합니다. 추출된 캡처된 SQL 데이터를 포함하는 파일 이름의 형식은 prefix_N.pdqxml이며, 여기서 N은 1로 시작하여 익스포트 중에 작성된 각 파일에 대해 증분되는 정수입니다.
예를 들어, -incrementalCapture "testApp" 옵션의 경우, 다음 파일이 생성됩니다.
testApp_1.pdqxml
testApp_2.pdqxml

캡처된 SQL 데이터를 pureQueryXML 데이터를 포함하는 저장소와 다른 저장소에서 검색할 수 있습니다. 캡처된 SQL 데이터를 포함하는 저장소에 대한 연결 정보를 명령행에 지정하십시오.

연결 정보 옵션에 대한 설명

다음 목록은 저장소 데이터베이스에 연결하는 데 필요한 정보에 대해 설명합니다.

-repositoryURL repository-database-URL
저장소 데이터베이스에 대한 URL을 지정합니다.
-repositoryUsername user-ID -repositoryPassword password
데이터베이스에 연결하는 데 사용되는 ID 및 암호를 지정합니다.
-repositoryDriverClass driverclass
저장소 데이터베이스에 연결하는 데 사용할 JDBC 드라이버 클래스의 완전한 클래스 이름을 지정합니다.

캡처된 SQL의 연결 정보 옵션에 대한 설명

extract runtimeGroup 옵션에만 사용됩니다. pureQuery 데이터를 추출할 때 캡처된 SQL을 포함하는 저장소가 다른 pureQuery 데이터와 독립된 저장소 데이터베이스에 있을 수 있습니다. 다음 목록은 캡처된 SQL을 포함하는 저장소 데이터베이스에 연결하는 데 필요한 연결 정보에 대해 설명합니다.

-incrementalRepositoryURL repository-database-URL
저장소 데이터베이스에 대한 URL을 지정합니다.
-incrementalRepositoryUsername user-ID -incrementalRepositoryPassword password
저장소 데이터베이스에 연결하는 데 사용되는 ID 및 암호를 지정합니다.
-incrementalRepositoryDriverClass driverclass
저장소 데이터베이스에 연결하는 데 사용할 JDBC 드라이버 클래스의 완전한 클래스 이름을 지정합니다.

두 가지 pureQueryXML 파일 간의 차이점이 나열된 보고서

ManageRepostiory -report pureQueryXMLChanges 옵션은 두 가지 pureQueryXML 파일 간의 차이에 대한 HTML 보고서를 작성합니다.

두 가지 버전의 pureQueryXLM 파일을 비교하는 보고서를 작성할 수 있습니다. 보고서에는 두 파일의 변경사항에 대한 요약 및 세부사항 정보가 포함됩니다. 보고서에 포함된 내용은 다음과 같습니다.
  • 버전 ID와 콜렉션 ID, 바인드 상태 및 추가, 제거 및 변경한 SQL문 수를 포함한 추가, 제거 및 변경된 패키지에 대한 정보.
  • 섹션 번호, 명령문이 마지막으로 실행된 시기 및 명령문이 실행된 횟수를 포함하여 패키지의 추가, 제거 및 변경된 SQL문에 대한 정보.

ManageRepository 유틸리티가 비교하는 pureQueryXML 파일은 파일 시스템에 있어야 합니다. 데이터베이스에 연결해야 합니다.

pureQueryXML 차이 보고서를 생성하기 위한 구문

구문 도표 읽기시각적 구문 도표 생략
    (1)                                             
>>-------java--com.ibm.pdq.tools.ManageRepository--------------->

>-- -report pureQueryXMLChanges-- -oldPureQueryXml--pureQueryXML-file-- -newPureQueryXml--pureQueryXML-file-- -file--report-file-><

연결 정보

|-- -repositoryURL--URL-to-repository-database------------------>

>-- -repositoryUsername--user-ID-- -repositoryPassword--password-->

>-- -repositoryDriverClass--driverclass-------------------------|

주:
  1. 임의의 순서로 옵션을 지정할 수 있습니다.

두 개의 pureQueryXML 파일 간 차이에 대한 보고서를 생성할 옵션에 대한 설명

다음 목록은 보고서를 생성하는 데 사용되는 ManageRepository 옵션 및 변수에 대해 설명합니다.

-report pureQueryXMLChanges
두 개의 pureQueryXML 파일 간 차이에 대한 HTML 보고서를 생성합니다.
-oldPureQueryXml original-pureQueryXML-file
원래 pureQueryXML 파일의 이름을 지정합니다.
-newPureQueryXml updated-pureQueryXML-file
갱신된 pureQueryXML 파일의 이름을 지정합니다.
-file file-name
보고서가 포함될 파일의 이름을 지정합니다.
-help
요약 사용 정보를 표시합니다.

연결 정보 옵션에 대한 설명

다음 목록은 저장소 데이터베이스에 연결하는 데 필요한 정보에 대해 설명합니다.

-repositoryURL repository-database-URL
저장소 데이터베이스에 대한 URL을 지정합니다.
-repositoryUsername user-ID -repositoryPassword password
데이터베이스에 연결하는 데 사용되는 ID 및 암호를 지정합니다.
-repositoryDriverClass driverclass
저장소 데이터베이스에 연결하는 데 사용할 JDBC 드라이버 클래스의 완전한 클래스 이름을 지정합니다.

사용 참고사항

동적 및 정적 SQL에 대한 저장소 지원
SQL문은 저장소에 액세스하고 이를 조작하는 데 사용됩니다. 정적 SQL을 지원하는 플랫폼의 경우 이러한 명령문은 데이터베이스에 정적으로 바인드될 수 있습니다. 다른 플랫폼에 대해서는 이러한 명령문이 동적으로 발행됩니다.

정적 SQL을 지원하는 플랫폼의 경우, -grant privilege 옵션 및 -privilege EXECUTEPACKAGE 옵션을 사용하면 애플리케이션이 정적으로 바인드된 명령문을 사용하여 메타데이터 저장소에 액세스할 수 있습니다. 정적 SQL을 지원하는 플랫폼의 경우, ManageRepository 유틸리티는 -bind packages가 발행된 후 바인드된 패키지를 사용하거나 동적 SQL문을 발행할 수 있습니다. 바인드된 패키지가 없거나 사용자에게 바인드된 패키지에 대한 실행 특권이 없는 경우, ManageRepository는 동적 SQL을 사용하여 저장소 테이블에 액세스합니다.

동적 플랫폼의 경우, -grant privilege 및 -privilege TABLEACCESS 옵션을 사용하면 동적 애플리케이션이 기본 메타데이터 저장소 테이블에 액세스할 수 있습니다. 정적 SQL을 지원하지 않는 이러한 플랫폼에 대해 사용 가능한 옵션은 이 옵션뿐입니다.

Optim Performance Manager 저장소에 대한 ManageRepository 지원

Optim Performance ManagerOptim Performance Manager Extended Insight는 pureQueryXML 데이터를 사용할 수 있습니다. data. ManageRepository 유틸리티는 pureQueryXML 데이터를 Optim Performance Manager 저장소에 업로드할 수 있습니다.

ManageRepository 유틸리티를 사용하여 pureQueryXML 데이터만 Optim Performance Manager 저장소에 업로드할 수 있습니다. pureQuery 런타임 특성와 같은 다른 데이터는 업로드할 수 없습니다.

ManageRepository 유틸리티를 사용하여 Optim Performance Manager 저장소에서 런타임 그룹을 작성, 갱신, 삭제 및 나열할 수 있습니다. 다른 ManageRepository 명령은 지원되지 않습니다.

Oracle 데이터베이스
Oracle 데이터베이스에서는, ManageRepository -create repository 옵션으로 저장소를 작성하기 전에 저장소에 대한 스키마를 작성해야 합니다. 기본 스키마는 IBMPDQ입니다. 예를 들어, 다음 Oracle SQL*Plus 명령을 실행하면 IBMPDQ라는 스키마 및 사용자가 Oracle 데이터베이스에 작성됩니다.
create user IBMPDQ identified by password

저장소를 작성할 때 데이터베이스에 대한 관리 특권이 있는 사용자가 저장소를 작성할 수 있습니다.

다음 예 ManageRepository 명령은 사용자 tiger에게 Oracle 데이터베이스 TEST에 대한 관리 특권이 있으며 스키마 IBMPDQ가 데이터베이스에 작성된다고 가정합니다.
java com.ibm.pdq.tools.ManageRepository 
  -create repository -repositoryType pureQueryOnly
  -repositoryURL jdbc:db2://test.ora.com:17593/test 
  -repositoryUsername tiger 
  -repositoryPassword testpwd 
  -repositoryDriverClass com.ibm.db2.jcc.DB2Driver
저장소를 작성하기 위한 ManageRepository 스크립트
저장소를 작성할 명령에서 -generateScriptOnly를 지정하여 저장소를 작성하는 스크립트를 생성할 수 있습니다. 일부 오브젝트 이름을 사용자 정의할 수 있는 반면, 다른 오브젝트 이름은 변경할 수 없습니다.

SQL문을 수정하고 스크립트를 실행하는 경우, -verify repository를 사용하여 저장소를 점검할 수 있습니다.

사용자 정의 스크립트를 사용하여 저장소를 작성하는 경우, 사용자 정의 스크립트로 저장소를 삭제해야 합니다. 저장소를 삭제할 명령에서 -generateScriptOnly를 지정하여 저장소를 삭제하는 스크립트를 작성합니다. 스크립트를 실행하기 전에 저장소를 작성할 때 사용한 스크립트에서 변경한 오브젝트 이름을 변경합니다.

저장소를 작성하기 위한 스크립트에서 다음 항목의 이름을 변경할 수 있습니다.
  • 데이터베이스 이름. 데이터베이스 이름은 CREATE TABLESPACE문의 IN 절에 지정되어 있습니다.
  • 테이블 스페이스 이름. 테이블 스페이스 이름은 CREATE TABLE문의 IN 절에 지정되어 있습니다.
  • 스토리지 그룹 ID. 스토리지 그룹 ID는 CREATE문의 USING STORGROUP 절에 지정되어 있습니다.
  • 버퍼 풀 ID. 버퍼 풀 ID는 BUFFERPOOL 절과 INDEXBP 절에 지정되어 있습니다.
저장소를 작성하기 위한 스크립트에서 다음 항목을 변경할 수 없습니다.
  • 스키마 이름 IBMPDQ.
  • 테이블 이름, 뷰 이름 및 해당 스키마 정의
  • -bind packages 옵션을 지정할 경우, 콜렉션 이름과 패키지 이름을 변경할 수 없습니다.
다음은 스크립트를 실행하기 위한 두 가지 방법입니다.
  • Optim Development Studio에서 SQL 및 XQuery 편집기를 사용하여 SQL 스크립트 파일에 있는 스크립트를 실행하십시오. SQL 및 XQuery 편집기에 대한 정보는 SQL문에 대한 작업을 참조하십시오.
  • DB2 명령행에서 파일에 있는 스크립트를 실행하십시오. DB2 명령행에서 저장소 데이터베이스에 연결한 후 스크립트를 실행하십시오. 다음 예제는 SAMPLE 데이터베이스에 연결하고 testcreate.sql 파일에 있는 스크립트를 실행합니다.
    db2 connect to sample
    db2 -tvf filename

    DB2 명령행에 대한 정보는 DB2 정보 센터의 명령행 처리기(CLP)를 참조하십시오.

예제

다음 명령은 연결 정보를 사용하여 데이터베이스에 대한 연결을 작성하고 저장소를 작성합니다.
java com.ibm.pdq.tools.ManageRepository 
  -create repository -repositoryType pureQueryOnly
  -repositoryURL jdbc:db2://test.user.com:17593/SAMPLE 
  -repositoryUsername mytestid 
  -repositoryPassword testpwd 
  -repositoryDriverClass com.ibm.db2.jcc.DB2Driver
다음 명령은 데이터베이스에 대한 연결을 작성하고 데이터베이스에 저장소를 작성할 수 있는 SQL 스크립트를 생성합니다.
java com.ibm.pdq.tools.ManageRepository 
  -create repository -repositoryType pureQueryOnly
  -repositoryURL jdbc:db2://test.user.com:17593/SAMPLE 
  -repositoryUsername mytestid 
  -repositoryPassword testpwd 
  -repositoryDriverClass com.ibm.db2.jcc.DB2Driver
  -generateScriptOnly D:\test\scripts\createtest.sql
다음 명령은 저장소를 제거합니다.
java com.ibm.pdq.tools.ManageRepository –delete repository
  -repositoryURL jdbc:db2://test.user.com:17593/SAMPLE 
  -repositoryUsername mytestid 
  -repositoryPassword testpwd 
  -repositoryDriverClass com.ibm.db2.jcc.DB2Driver

피드백