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 전역 등록 정보에 정의된 모든 응용프로그램 레벨 값은 무시됩니다.

피드백