pureQuery 런타임 특성을 사용하여
pureQuery Runtime이 pureQuery 정보를 검색하고 캡처된 SQL 데이터를
저장하기 위해 사용하는 위치를 제어할 수 있습니다.
특성
다음 특성은
pureQuery Runtime이 pureQuery 데이터를 검색하고 저장하는 방법을 제어합니다.
- finalRepositoryProperties
- pureQuery 런타임 특성 및 pureQueryXML 파일 정보를
검색할 때 사용할 위치를 지정합니다.
- outputPureQueryXml
- pureQuery 클라이언트 최적화에 사용 가능한 애플리케이션에서
캡처된 SQL 데이터를 저장하기 위해 사용되는 파일 이름을 지정합니다.
- outputXmlRepository
- SQL 관리 저장소를 포함하는 데이터베이스를 지정합니다.
저장소는 pureQuery 클라이언트 최적화에 사용 가능한 애플리케이션에서
캡처된 SQL 데이터를 저장합니다. 특성은 저장소에서 검색되는
특성 세트에서만 지정할 수 있습니다. outputXmlRepository 특성이
저장소에서 검색되지 않는 경우 예외가 발생합니다.
- propertiesGroupId
- 데이터를 검색하거나 데이터를 SQL 관리 저장소에 저장할 때
사용할 런타임 그룹 ID를 SQL 관리 저장소에 지정합니다.
- propertiesRefreshInterval
- pureQuery 특성 및 pureQueryXML 데이터에 대한
갱신사항 점검 간격을 지정합니다.
특성에 대한 규칙
finalRepositoryProperties 특성을 사용하여
pureQueryXML 파일 정보를 검색할 때 다음 규칙이 적용됩니다.
- finalRepositoryProperties 특성이
pureQuery 특성의 위치로 파일을 지정하는 경우, pureQueryXml 특성을 사용하여
pureQueryXML 파일의 경로 및 이름을 지정해야 합니다. pureQueryXml 특성이
지정되지 않은 경우, pureQueryXML이 사용되지 않습니다.
- finalRepositoryProperties 특성이 저장소를
지정하는 경우, propertiesGroupId 특성으로 지정된
런타임 그룹의 활성 버전에서 pureQueryXML 데이터가 검색됩니다.
또한 pureQueryXml 특성이 지정된 경우,
예외가 발생합니다.
captureMode 특성이 ON으로 설정되고
finalRepositoryProperties 특성이 저장소를 지정할 때 캡처된 SQL을 저장하는 데
다음 규칙이 적용됩니다.
- outputPureQueryXml 특성이 설정되지 않은 경우,
다음 특성 설정이 캡처된 SQL이 저장되는 위치를 판별합니다.
- outputPureQueryXml 특성은 설정되고
outputXmlRepository 특성은 설정되지 않은 경우,
캡처된 SQL이 파일 시스템에 저장됩니다. 다중 캡처 파일을 지정하는 $X 구문이
지원됩니다.
- outputPureQueryXml 및 outputXmlRepository 특성이
모두 설정된 경우, 예외가 발생합니다.
finalRepositoryProperties 특성으로
저장소를 지정한 경우에도 캡처된 SQL 데이터를 파일 시스템에 저장할 수 있습니다.
outputPureQueryXml 특성을 사용하여 파일 시스템을 지정하십시오.
캡처된
SQL 데이터를 저장소에 저장하는 것은 captureMode 특성으로 제어되지만
finalRepositoryProperties 특성이 저장소를 지정하는 경우에만
지원됩니다.
pureQuery 런타임 특성이 파일 시스템에서
검색되는 경우, 파일 시스템이 검색 및 저장에 사용됩니다. 파일을 지정하려면 pureQueryXml 특성 및
outputPureQueryXml 특성을
사용해야 합니다.
finalRepositoryProperties 특성 지정은
다른 pureQuery 클라이언트 최적화 특성이 사용 가능하지 않은 경우에도
pureQuery 클라이언트 최적화가 사용 가능함을 표시합니다.
pureQuery 특성 및 저장소 지원
요약
다음 테이블은 pureQuery 특성을
파일 시스템에 사용하는 경우 및 저장소에서 사용하는 경우에 대한 지원을
요약합니다.
표 1. 새 pureQuery 특성 및 이전 pureQuery 특성의
상호 작용 테이블특성 |
특성 파일에 있거나 명령행에 지정된 경우
유효함 |
저장소에 지정된 경우 유효함 |
파일 또는 명령에 지정되어 있고
pureQuery Runtime이 저장소의 특성을 사용하는 경우 유효함 |
allowDynamicSQL |
X |
X |
|
allowGetterSetterMethodWithPublicField |
X |
|
|
allowMDMBeanRules |
X |
|
|
capturedOnly |
X |
X |
|
captureMode |
X |
X |
|
captureStatementBatchSQL |
X |
X |
|
disableJDBCPrerequisiteEnforcement |
X6 |
|
X6 |
enableDynamicSQLReplacement |
X |
X |
|
executionMode |
X |
X |
|
finalRepositoryProperties |
X |
|
|
ignoreOrphanGetterSetterMethods |
X |
|
|
maxNonParmSQL |
X |
X |
|
maxResultRows |
X |
|
|
maxStackTracesCaptured |
X |
X |
|
outputPureQueryXml |
X3 |
X4 |
|
outputXmlRepository |
|
X |
|
packagePrefixExclusions |
X |
X |
|
propertiesGroupId |
X1 |
|
|
propertiesRefreshInterval |
X2 |
X |
|
pureQueryXml |
X3 |
X |
|
queryTimeoutInSeconds |
X |
|
|
sqlLiteralSubstitution |
X |
X |
|
stackTraceDepth |
X |
X |
|
traceFile5 |
X6 |
|
X6 |
traceLevel5 |
X6 |
|
X6 |
cmx.controllerDiscoveryInterval |
X6 |
|
X6 |
cmx.controllerDiscoveryPort |
X6 |
|
X6 |
cmx.controllerURL |
X6 |
|
X6 |
cmx.dataSourceLookupInterval |
X6 |
|
X6 |
cmx.multicastTimeToLive |
X6 |
X6 |
X6 |
참고: - finalRepositoryProperties 특성이 저장소를 참조하는 경우에만
유효합니다.
- finalRepositoryProperties 특성이 지정된 경우에만
유효합니다.
- finalRepositoryProperties 특성이 지정되지 않은 경우에만
유효합니다.
- finalRepositoryProperties 특성이 파일 시스템을 참조하는 경우에만
유효합니다.
- pureQuery 클라리언트 최적화를 사용한 추적은
애플리케이션 레벨에서의 추적을 지원하지 않습니다.
- 전역 pureQuery 특성만 점검됩니다. finalRepositoryProperties, pdqappwide.properties,
targetDSName.properties, DataSource, pdqProperties 또는 JCC 전역 특성에 정의된
모든 애플리케이션 레벨 값은 무시됩니다.