시나리오: pureQueryXML 파일 구성 및 파일에 SQL문 바인드

pureQuery Merge 유틸리티로 작성한 pureQueryXML 파일에는 WebSphere® 애플리케이션에서 캡처된 SQL문이 포함되어 있습니다. pureQuery Configure 유틸리티를 사용하여 DB2® 패키지의 특성을 pureQueryXML 파일에 지정합니다. StaticBinder 유틸리티를 사용하여 SQL문 및 pureQueryXML 파일의 기타 정보에서 DB2 패키지를 작성하고 트랜잭션 데이터베이스에 패키지를 바인드합니다.

이 태스크 정보

Configure 유틸리티의 한 가지 중요한 기능은 pureQueryXML 파일의 SQL문을 이름 지정된 명령문 세트로 그룹화하는 것입니다. 명령문 세트의 이름은 -rootPkgName 옵션의 값에 기반하고 그룹화는 지정한 Configure 옵션에 기반합니다.

pureQuery StaticBinder 유틸리티로 SQL문이 포함된 패키지를 작성하고 데이터베이스에 이 패키지를 바인드합니다. 시나리오 환경에서는 규정자 TEST를 사용하는 테스트 데이터베이스에 패키지를 작성합니다. StaticBinder 유틸리티는 pureQueryXML 파일에 정의된 명령문 세트에서 패키지를 작성합니다.

프로시저

pureQueryXML 파일을 구성하고 SQL문을 파일에 바인드하려면 다음을 수행하십시오.

  1. 캡처한 SQL문이 포함된 pureQueryXML 파일을 구성하십시오.
    pureQueryXML 파일 testApp.pdqxml에서 Configure 유틸리티를 사용하려면 다음 명령을 실행하십시오.
    java com.ibm.pdq.tools.Configure 
      -rootPkgName testApp 
      -cleanConfigure TRUE
      -pureQueryXml testApp.pdqxml 
      –validateXml TRUE 

    -cleanConfigure TRUE 옵션은 Configure 유틸리티가 전체 파일을 구성하도록 지정합니다. 이전에 구성한 pureQueryXML 파일을 구성 중이면 -cleanConfigure FALSE 옵션을 사용할 수 있습니다. Configure 유틸리티는 이전에 구성되어 pureQueryXML 파일에 바인드된 기존 명령문 세트의 컨텐츠를 보존하려 시도합니다.

    -validateXml 옵션은 Configure 유틸리티가 pureQueryXML 스키마에 대해 pureQueryXML 파일의 XML 유효성 확인을 수행함을 지정합니다. Configure 유틸리티는 pureQueryXML 파일에 있는 XML 구문 오류를 표시합니다.

    팁: 기본으로 Configure 유틸리티는 콜렉션 NULLID를 사용합니다. 다른 콜렉션을 사용하게 하려면 -collection 옵션을 통해 콜렉션을 지정할 수 있습니다.
  2. SQL문을 pureQueryXML 파일에 바인드하십시오.
    이 시나리오에서는 애플리케이션이 테스트 환경에서 실행 중이며 SQL문은 테스트 환경에 캡처되었습니다. 테스트 환경에서 캡처한 SQL문을 바인드하려면 pureQuery StaticBinder 유틸리티를 -bindOption "QUALIFIER TEST" 옵션과 함께 실행하여 SQL문을 테스트 데이터베이스에 바인드하십시오.
    java com.ibm.pdq.tools.StaticBinder –url "jdbc:db2://testserver.test.com:32706/sample retrieveMessagesFromServerOnGetMessage=1;" 
      -username "myuser" -password "mypwd"
      -isolationLevel CS 
      -bindOptions "QUALIFIER TEST"  
      -pureQueryXml testApp.pdqxml -showDetails TRUE

    StaticBinder 유틸리티는 pureQueryXml 파일에 표시된 연결로 패키지를 바인드합니다.

    StaticBinder 옵션 -isolationLevel CS는 StaticBinder가 분리 수준 커서 안정성(CS)의 단일 패키지를 작성함을 지정합니다. CS 분리 수준은 Linux, UNIX 및 Windows용 DB2 데이터베이스의 기본 레벨입니다.

    팁: 테스트 환경에서 프로덕션 환경으로 애플리케이션을 마이그레이션할 경우 테스트 환경과 다른 스키마가 프로덕션 환경에 사용될 수 있습니다. 스키마가 다르면 올바른 QUALIFIER 바인드 옵션을 지정하는지 확인하십시오. 이 시나리오에서는 테스트 환경 스키마가 TEST이고 프로덕션 환경 스키마가 PROD입니다. 프로덕션 환경의 경우, 패키지를 프로덕션 데이터베이스에 작성하기 위해 StaticBinder 유틸리티 바인드 옵션 -bindOptions "QUALIFIER PROD"를 지정합니다.

    명령의 출력은 다음 예와 유사합니다.

    IBM Optim pureQuery Runtime 2.2.0.3 build 2.18.118
    Licensed Materials - Property of IBM
    5724-U16
    (c) Copyright IBM Corp. 2006, 2010 All Rights Reserved.
    
    ================================================================================
    
    The StaticBinder utility is beginning the bind operation for the 
    pureQueryXml file 'C:\test\pureQuery-test\zz-merged.pdqxml'.
    
    Starting to process options:  -url "jdbc:db2://testserver.test.com:32706/sample
    " -username "*****" -password "*****" 
    -pureQueryXml "testApp.pdqxml"
    -isolationLevel "CS" 
    -bindOptions "QUALIFIER TEST" -showDetails "true"
    
    The StaticBinder utility successfully bound the package 'TESTAPP' 
    for the isolation level 'CS'.
    
    Number of statements input: '8', number of statements bound : '8', 
    bind options: 'ISOLATION CS QUALIFIER TEST'
    
    The bind operation completed successfully for 'testApp.pdqxml'.
        Number of packages input :'1'
        Number of input packages for which isBindable is false: '0'
        Number of input packages with zero bindable statements: '0'
        Number of bindable input packages processed by the Static Binder utility: '1' : [TESTAPP]
    
    ================================================================================
    
    StaticBinder 유틸리티의 활동 결과:
    
    바인드 조작이 성공한 항목 수: 1

다음에 수행할 작업

다음 태스크에서는 애플리케이션이 SQL문을 정적으로 실행할 수 있게 하는 pureQuery Runtime 특성 및 pureQueryXML 파일로 저장소를 업데이트합니다.


피드백