pureQuery 데이터의 위치를 제어하는 pureQuery 런타임 특성

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이 저장되는 위치를 판별합니다.
    • outputXmlRepository 특성이 설정되지 않은 경우, 캡처된 SQL은 finalRepositoryPropertiespropertiesGroupId 특성으로 지정된 런타임 그룹 및 저장소에 저장됩니다.
    • outputXmlRepository 특성이 설정된 경우, 캡처된 SQL은 finalRepositoryPropertiespropertiesGroupId 특성으로 지정된 런타임 그룹의 저장소에 저장됩니다.
      주: outputXmlRepository 특성은 데이터 소스 또는 JDBC URL 지정은 지원하지만 파일 시스템 지정은 지원하지 않습니다.
  • outputPureQueryXml 특성은 설정되고 outputXmlRepository 특성은 설정되지 않은 경우, 캡처된 SQL이 파일 시스템에 저장됩니다. 다중 캡처 파일을 지정하는 $X 구문이 지원됩니다.
  • outputPureQueryXmloutputXmlRepository 특성이 모두 설정된 경우, 예외가 발생합니다.

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
참고:
  1. finalRepositoryProperties 특성이 저장소를 참조하는 경우에만 유효합니다.
  2. finalRepositoryProperties 특성이 지정된 경우에만 유효합니다.
  3. finalRepositoryProperties 특성이 지정되지 않은 경우에만 유효합니다.
  4. finalRepositoryProperties 특성이 파일 시스템을 참조하는 경우에만 유효합니다.
  5. pureQuery 클라리언트 최적화를 사용한 추적은 애플리케이션 레벨에서의 추적을 지원하지 않습니다.
  6. 전역 pureQuery 특성만 점검됩니다. finalRepositoryProperties, pdqappwide.properties, targetDSName.properties, DataSource, pdqProperties 또는 JCC 전역 특성에 정의된 모든 애플리케이션 레벨 값은 무시됩니다.

피드백