애플리케이션 환경의 pureQuery Runtime 특성 지원

pureQuery API, pureQuery 클라이언트 최적화 또는 CLI(Call Level Interface)를 통합하는 애플리케이션에 pureQuery Runtime이 사용될 때의 지원되는 특성에 대한 요약입니다.
다음 표에는 pureQuery Runtime 특성 및 지원되는 애플리케이션 환경이 나열됩니다.
표 1. pureQuery 특성 및 지원되는 애플리케이션 환경
특성 설명 pureQuery API를 사용한 Java™ 애플리케이션3 pureQuery 클라이언트 최적화를 사용한 Java 애플리케이션 pureQuery 클라이언트 최적화를 사용한 CLI 애플리케이션
allowDynamicSQL1 애플리케이션이 pureQueryXML 파일에서 캡처되지 않는 SQL문을 동적으로 실행하는지 아니면 캡처되지만 바인드되지는 않는 SQL문을 동적으로 실행하는지를 지정합니다.   X X
capturedOnly2 pureQueryXML 파일에 있는 SQL문만을 실행할 지 여부를 지정합니다. X X X
captureMode SQL문에 관한 정보를 캡처할지 여부를 지정합니다. X X X
captureStatementBatchSQL 애플리케이션이 maxNonParmSQL 특성으로 지정된 SQL문(SELECT문은 제외)의 최대 수까지 Statement.addBatch() 메소드로 전달하는 SQL DML문을 캡처할지 여부를 지정합니다. X X  
enableDynamicSQLReplacement pureQueryXML 파일에 추가되었으며 원래 명령문 및 대체 명령문이 바인드되지 않은 대체 SQL문을 실행할지 여부를 지정합니다. X X X
executionMode pureQuery 런타임에 의해 이전에 캡처되어 저장된 SQL문을 정적으로 실행할지 여부를 지정합니다. X X X
finalRepositoryProperties pureQuery 사용 애플리케이션에 사용되는 pureQuery 특성의 위치를 지정합니다.   X  
maxNonParmSQL 캡처할 매개변수화되지 않은 SQL문의 최대수를 지정합니다. 이 옵션은 captureMode의 값이 ON인 경우에만 적용됩니다. captureMode가 OFF인 경우, pureQuery는 이 매개변수를 무시합니다. X X X
maxResultRow 쿼리 결과에서 명령문이 리턴하는 최대 행 수를 지정합니다. X    
maxStackTracesCaptured 사용자가 캡처하는 각 SQL문의 정의 지점 및 실행 지점에 대해 기록되는 최대 스택 추적 수를 지정합니다. X X  
outputPureQueryXml SQL문을 캡처하는 프로세스가 작성되는 파일의 이름 및 완전한 경로 또는 상대 경로를 지정합니다. X X  
outputXmlRepository 저장소가 포함된 데이터베이스를 지정합니다. 저장소는 pureQuery 클라이언트 최적화를 위해 사용되는 애플리케이션에서 캡처된 SQL 데이터를 저장합니다.   X  
packagePrefixExclusions 스택 추적에 포함하지 않을 Java 패키지의 도메인 및 하위 도메인으로 구성된 파이프 구분 목록을 지정합니다. X X  
propertiesGroupId 데이터베이스에서 작성된 저장소의 런타임 그룹 ID을 지정합니다. pureQuery 런타임은 런타임 그룹 ID 및 애플리케이션에서 캡처된 SQL 데이터를 저장하거나 pureQuery 런타임 구성 및 pureQueryXML 파일 정보를 검색하기 위한 저장소를 지정하는 연결 정보를 사용합니다.   X  
propertiesRefreshInterval pureQuery 클라이언트 최적화에서 pureQuery 특성 또는 pureQueryXML 데이터 변경사항에 대해 저장된 pureQuery 데이터의 위치를 점검하기 전까지 대기하는 지속기간(분)을 지정합니다. 갱신사항이 발견되는 경우 pureQuery 클라이언트 최적화에서 갱신된 pureQuery 런타임 특성 및 pureQueryXML 데이터를 검색하여 갱신된 정보를 사용합니다.   X  
pureQueryXml SQL문 캡처 프로세스에서 작성되거나 그 프로세스의 결과로 이미 존재하는 파일의 이름 및 완전한 경로나 상대 경로를 지정합니다. X X X
queryTimeoutInSeconds SQL문이 실행될 때까지 대기하는 시간(초)입니다. X    
repositoryRequired pureQuery 데이터를 검색하거나 기록하는 동안 오류가 발생하는 경우의 pureQuery 클라이언트 최적화 동작을 지정합니다. finalRepositoryProperties 특성에 지정된 위치에서 pureQuery 런타임 특성 및 pureQueryXML 데이터를 검색할 수 없거나 캡처된 SQL이 저장된 저장소에 액세스할 수 없는 경우   X  
sqlLiteralSubstitution 리터럴 대체를 수행할지 여부를 지정합니다. pureQuery 런타임에서 매개변수 표시문자로 SQL문의 리터럴 값을 대체하고 명령문의 매개변수화된 버전을 캡처하려고 시도합니다. X X X
stackTraceDepth 각 SQL문에 대해 기록되는 스택 추적 항목의 최대 수를 지정합니다. 해당 엔트리는 pureQueryXML 파일에 기록됩니다. X X  
traceFile 로그를 기록할 실제 파일을 지정합니다. pureQuery 로그 유틸리티가 실행되는 디렉토리에 상대적인 경로 또는 절대 경로를 사용할 수 있습니다. X X X
traceLevel 로그 파일에 기록할 세부사항 레벨을 지정합니다. X X X
주:
  1. executionMode 특성의 값이 STATIC일 때에만 특성이 적용됩니다.
  2. SQL문을 캡처 중일 때에는 capturedOnly 특성의 값을 TRUE로 설정할 수 없습니다.
  3. pureQuery 특성을 pureQuery EnhancedDataSource 인터페이스 또는 DataFactory 클래스와 함께 사용할 수 있습니다.
    com.ibm.pdq.runtime.datasource Interface EnhancedDataSource
    capturedOnly
    captureMode
    captureStatementBatchSQL
    enableDynamicSQLReplacement
    maxNonParmSQL
    maxStackTracesCaptured
    outputPureQueryXml
    packagePrefixExclusions
    pureQueryXml
    stackTraceDepth
    sqlLiteralSubstitution
    com.ibm.pdq.runtime.factory.DataFactory
    executionMode
    queryTimeoutInSeconds
    maxResultRows

피드백