옵션 파일을 사용하여 클라이언트 최적화를 위해 StaticBinder 유틸리티를 실행하기 위한 구문

명령 및 옵션 파일을 사용하여 pureQueryXML 파일의 이름과 이 파일을 기반으로 하는 DB2® 패키지 또는 DBRM 파일 작성을 위한 옵션을 지정할 수 있습니다.pureQueryXML 파일이 하나만 있는 경우에도 옵션 파일을 사용할 수 있습니다.

명령에 pureQueryXML 파일을 나열하고 옵션 파일에서는 defaultOptions 엔트리만 사용할 수 있습니다.

명령과 옵션 파일에서 pureQueryXML 파일을 나열할 수 있습니다. 파일이 명령과 옵션 파일 모두에 나열되는 경우 StaticBinder 유틸리티는 파일을 처리합니다. 파일이 옵션 파일에는 나열되지만 명령에는 나열되지 않는 경우 StaticBinder 유틸리티는 파일을 처리하지 않습니다. 파일이 명령에 나열되지만 옵션 파일에는 나열되지 않는 경우 StaticBinder 유틸리티는 명령행의 옵션과 옵션 파일의 defaultOptions 엔트리로 파일을 처리합니다.

명령행에서 StaticBinder 유틸리티를 실행하고 옵션 파일을 사용하는 경우, 유틸리티는 다음 우선순위 순서대로 옵션을 인식합니다.
  1. 명령행의 옵션
  2. 개별 pureQueryXML 파일에 대한 옵션과 지정된 옵션 파일에 있는 명령문 세트
  3. 지정된 옵션 파일의 기본 옵션
구문 도표 읽기시각적 구문 도표 생략
                                        (1)   
>>-java--com.ibm.pdq.tools.StaticBinder------------------------->

>--+---------------------------------------------------------------------------------------------------------------+-->
   |  (2)                                                                                                          |   
   '------- -url--jdbc--:--db2--:--//--server--+---------+--/--database-- -username--user-ID-- -password--password-'   
                                               '-:--port-'                                                             

>--+-----------------------------------------------------------------+-->
   |                 .---------------------------------------------. |   
   |                 V                                             | |   
   '- -pureQueryXml----+-pureQueryXML-file-----------------------+-+-'   
                       '-pureQueryXML-file--:--base-package-name-'       

>-- -optionsFile--file-name--+-----------------------------+---->
                             |                   .-FALSE-. |   
                             '- -differenceOnly--+-TRUE--+-'   

>--+--------------------------+--+-----------------------+------>
   |                .-FALSE-. |  |                   (3) |   
   '- -showDetails--+-TRUE--+-'  '-| Trace options |-----'   

>--+-------------------------------+---------------------------->
   '- -verifyPackages--+-DETAIL--+-'   
                       '-SUMMARY-'     

>--+--------------------------+--------------------------------><
   |                .-FALSE-. |   
   '- -validateXml--+-TRUE--+-'   

주:
  1. 임의의 순서로 옵션을 지정할 수 있습니다.
  2. 명령에 URL, 사용자 ID 및 암호를 지정하지 않는 경우, DBRM 파일만 작성하지 않으려면 옵션 파일에서 지정해야 합니다.
  3. 구문의 경우 해당 옵션의 설명을 참조하십시오.

옵션에 대한 설명

-optionsFile file-name
바인드하려는 SQL문을 포함하는 pureQueryXML 파일을 나열하는, 절대 또는 상대 경로를 포함하는 파일의 이름입니다.
-password password
데이터 소스에 연결하는 데 사용하는 암호입니다.
-pureQueryXml pureQueryXML-file|pureQueryXML-file:base-package-name
패키지로 바인드할 SQL문 세트들을 포함하는 pureQueryXML 파일이나 패키지로 바인드할 단일 SQL문 세트를 지정합니다. 두 개 이상의 값을 지정할 수 있습니다.
pureQueryXML-file
pureQueryXML 파일의 이름입니다. 예: C:\directory\captureFile.pdqxml
이 파일의 확장자는 .pdqxml 또는 .xml이어야 합니다.파일은 애플리케이션의 클래스 경로에 있는 자원이거나 파일의 전체 또는 상대 경로를 제공해야 합니다.
pureQueryXML-file:base-package-name
pureQueryXML 파일의 이름이고 바인드할 패키지의 기본 이름입니다(예: C:\directory\captureFile.pdqxml:MYPKGA).

파일 확장자는 .pdqxml 또는 .xml이어야 합니다. 파일은 애플리케이션의 클래스 경로에 있는 자원이거나 파일의 전체 또는 상대 경로를 제공해야 합니다.

패키지의 기본 이름은 pureQueryXML 파일에서 패키지를 설명하는 package 요소의 name 속성 값입니다. 기본 이름은 다음 두 파트로 구성됩니다.
  • 루트 패키지 이름
  • 둘 이상의 패키지 이름이 필요할 때 Configure 유틸리티가 루트 패키지 이름에 추가하는 문자. 예를 들어, 해당 유틸리티는 명령문 세트에 있는 SQL문의 개수가 Configure 유틸리티 -sqlLimit 옵션 값을 초과할 경우 둘 이상의 패키지 이름을 작성합니다.
주: pureQueryXML 파일을 구성할 때 Configure 유틸리티 옵션 -forceSingleBindIsolation을 지정한 경우 StaticBinder 유틸리티가 패키지 이름에 정수를 추가하지 않습니다. 해당 정수는 패키지에 있는 모든 SQL문에 적용되는 분리 수준을 나타냅니다.
단일 명령에서 -pureQueryXml-optionsFile과 함께 사용하는 경우 많은 결과가 가능합니다. 명령에서 pureQueryXML 파일 및 명령문 세트를 지정할 때 옵션 파일 사용을 참조하십시오.
Trace options
메시지를 로그할 파일 및 로그할 정보 레벨을 지정할 수 있습니다.
구문 도표 읽기시각적 구문 도표 생략
>>-+------------------------+--+---------------------------+---><
   '- -traceFile--file-name-'  |               .-OFF-----. |   
                               '- -traceLevel--+-ALL-----+-'   
                                               +-SEVERE--+     
                                               +-WARNING-+     
                                               +-INFO----+     
                                               +-CONFIG--+     
                                               +-FINE----+     
                                               +-FINER---+     
                                               '-FINEST--'     

-traceFile file-name
조작에 대한 정보를 로그하는데 사용하려는 절대 또는 상대 경로 및 파일 이름을 지정합니다.
파일이 이미 존재한다면 pureQuery는 새 메시지를 파일의 기존 컨텐츠에 추가합니다.기본으로, 엔트리는 System.err에 기록됩니다.
-traceLevel OFF|SEVERE|WARNING|INFO|CONFIG|FINE|FINER|FINEST|ALL
로그할 정보 유형을 지정합니다. 기본 레벨은 OFF입니다. 로그 엔트리를 기록할 파일을 지정하지 않고 이 옵션을 OFF가 아닌 다른 값으로 설정하는 경우, 엔트리는 System.err에 기록됩니다.
-url connection-URL
데이터베이스를 연결하기 위한 유형 4 JDBC URL입니다.
이름 지정된 매개변수 표시문자를 사용하는 SQL문을 바인드할 경우, 데이터 소스에 대한 연결을 지정할 때 값이 1인 enableNamedParameterMarkers 특성을 지정해야 합니다. 다음 예제 -url 옵션은 testserver.test.com의 SAMPLE 데이터베이스에 연결하고 enableNamedParameterMarkers 특성을 지정합니다.
-url jdbc:db2://localhost:50000/SAMPLE:enableNamedParameterMarkers=1;
-username user-ID
데이터 소스에 연결하는 데 사용하는 사용자 ID입니다.
-verifyPackages DETAIL|SUMMARY
StaticBinder 유틸리티가 pureQueryXML 파일과 연관된 SQL문으로 존재하거나 존재하지 않는 패키지의 보고서를 작성할 것인지 여부를 지정합니다. 이 옵션을 사용하면 StaticBinder 유틸리티가 패키지를 바인드하지 않습니다.

예를 들어, myApp.pdqxml이라는 pureQueryXML에서 Configure 유틸리티를 실행했다고 가정합니다. 유틸리티를 실행했을 때 -collection, -pkgVersion 및 -rootPkgName 옵션에 대한 값이 제공되었으며 유틸리티는 이들 값을 pureQueryXML 파일에 저장했습니다. 이 파일의 이름을 지정하는 StaticBinder 유틸리티를 실행하면 유틸리티가 DB2 패키지를 작성합니다.

나중에 StaticBinder 유틸리티가 pureQueryXML 파일에서 작성한 패키지 목록을 볼 수 있습니다. 유틸리티를 실행 시, -verifyPackages 옵션을 사용하여 DETAIL 값을 지정하고 다시 파일 이름을 제공할 수 있습니다.

Configure 유틸리티를 pureQueryXML 파일에서 실행한 다음 StaticBinder 유틸리티를 실행한 후, 파일에서 다시 Configure 유틸리티를 실행하지 않고 -collection, -pkgVersion 및 -rootPkgName에 대해 다른 값을 제공하지 않았다는 전제 하에서 -verifyPackages 옵션이 동작합니다.

먼저 StaticBinder 유틸리티를 실행하고 -collection, -pkgName 및 -rootPkgName 값을 변경한 후 Configure 유틸리티를 myApp.pdqxml에서 실행하면 StaticBinder 유틸리티가 이들 옵션의 새 값과 일치하는 패키지를 찾지 못합니다. 보고서에서 StaticBinder 유틸리티는 찾고 있는 패키지가 없다고 보고합니다.

-collection, -pkgVersion 및 -rootPkgName 옵션 값이 StaticBinder 유틸리티를 이전에 실행했을 때와 같다면, 유틸리티가 해당 패키지를 찾아 나열합니다.

이 옵션은 -bindOptions 옵션과 함께 지정할 수 있습니다. 하지만 StaticBinder 유틸리티는 패키지를 바인드하지 않습니다. 패키지를 작성할 때 이 옵션을 사용하여 콜렉션을 지정한 경우 -bindOptions만을 사용하여 검증할 패키지 콜렉션을 지정하십시오.

세부사항
-collection, -pkgVersion 및 -rootPkgName 값을 기본으로 하는 다음 정보를 설명하는 보고서를 작성합니다.
  • 존재하지 않는 패키지.
  • 존재하는 패키지. 각 패키지에 대해 보고서는 이름, 일관성 토큰, 시간소인 및 분리 레벨을 나열합니다.
  • 존재하거나 존재하지 않는 패키지 수.
요약
-collection, -pkgVersion, 및 -rootPkgName의 값을 부여하는 존재하거나 존재하지 않는 패키지를 나열하는 보고서를 작성합니다.
-validateXml TRUE|FALSE
XML 스키마 유효성 확인이 pureQueryXML 스키마를 사용하여 입력 pureQueryXML 파일에서 수행되는지 여부를 지정합니다. 값이 TRUE인 경우 유효성 확인이 수행됩니다. 값이 FALSE이거나 옵션이 지정되지 않으면 유효성 확인이 수행되지 않습니다.

XML 스키마 유효성 확인의 성공 또는 실패가 판별되며 각 입력 파일에 대해 보고됩니다. 하나의 입력 파일이 실패하는 경우, StaticBinder 처리는 중지되지 않으며 연속되는 파일이 처리됩니다.

pureQueryXML 파일이 스키마 유효성 확인을 실패하는 경우 해당 파일 내의 패키지는 바운드되지 않습니다. 첫 번째 스키마 유효성 확인 오류 및 해당 파일의 바인드 실패가 보고됩니다.

현재 릴리스 또는 이전 버전 pureQueryXML 파일만 유효성 확인됩니다(버전 4 또는 3). 이전 버전 pureQueryXML이 발견되는 경우, 유효성 확인은 해당 파일에서 수행되지 않습니다.


피드백