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

pureQuery API, pureQuery 클라이언트 최적화 또는 CLI(Call Level Interface)를 통합하는 애플리케이션에 pureQuery Runtime이 사용될 때의 지원되는 특성에 대한 요약입니다.
다음 표에는 pureQuery Runtime 특성 및 지원되는 애플리케이션 환경이 나열됩니다.
표 1. pureQuery 특성 및 지원되는 애플리케이션 환경
특성 설명 pureQuery API를 사용한 Java 애플리케이션4 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  
com.ibm.pdq(pureQuery 컴포넌트 로그 특성) 다양한 pureQuery 컴포넌트의 로그 레벨 설정을 지정합니다. X X  
dumpLogsOnSqlCodes 로그 레코드가 메모리에 저장되는 경우 이 특성은 로그 파일로의 레코드 기록을 트리거하는 SQL 오류 코드를 지정합니다. X X  
dumpLogsExcludingSqlCodes 로그 레코드가 메모리에 저장되는 경우 이 특성은 로그 레코드 기록을 트리거하지 않는 SQL 오류 코드를 지정합니다. 이 특성은 dumpLogsOnSqlCodes 특성과 함께 사용됩니다. 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 X
propertiesRefreshInterval pureQuery 클라이언트 최적화에서 pureQuery 특성 또는 pureQueryXML 데이터 변경사항에 대해 저장된 pureQuery 데이터의 위치를 점검하기 전까지 대기하는 지속기간(분)을 지정합니다. 업데이트사항이 발견되는 경우 pureQuery 클라이언트 최적화에서 업데이트된 pureQuery 런타임 특성 및 pureQueryXML 데이터를 검색하여 업데이트된 정보를 사용합니다.   X  
pureQueryXml SQL문 캡처 프로세스에서 작성되거나 그 프로세스의 결과로 이미 존재하는 파일의 이름 및 완전한 경로나 상대 경로를 지정합니다. X X X
pureQueryXmlRepository pureQuery 클라이언트 최적화가 적용된 CLI 애플리케이션에서 사용되는 pureQueryXML 파일 데이터의 저장소를 지정합니다.     X
queryTimeoutInSeconds SQL문이 실행될 때까지 대기하는 시간(초)입니다. X    
repositoryRequired pureQuery 데이터를 검색하거나 기록하는 동안 오류가 발생하는 경우의 pureQuery 클라이언트 최적화 동작을 지정합니다. finalRepositoryProperties 특성에 지정된 위치에서 pureQuery 런타임 특성 및 pureQueryXML 데이터를 검색할 수 없거나 캡처된 SQL이 저장된 저장소에 액세스할 수 없는 경우   X X
sqlLiteralSubstitution 리터럴 대체를 수행할지 여부를 지정합니다. pureQuery 런타임에서 SQL문의 리터럴 값을 매개변수 마커로 대체하고 매개변수가 지정된 명령문 버전을 실행합니다. X X X
stackTraceDepth 각 SQL문에 대해 기록되는 스택 추적 항목의 최대 수를 지정합니다. 해당 엔트리는 pureQueryXML 파일에 기록됩니다. X X  
traceBufferRowCount 메모리에 버퍼링되는 추적 정보 로그 레코드의 수를 지정합니다. X X  
traceFile3 로그를 기록할 파일을 지정합니다. pureQuery 로그 유틸리티가 실행되는 디렉토리에 상대적인 경로 또는 절대 경로를 사용할 수 있습니다. X X X
traceLevel3 로그 파일에 기록할 세부사항 레벨을 지정합니다. X X X
주:
  1. executionMode 특성의 값이 STATIC일 때에만 특성이 적용됩니다.
  2. SQL문을 캡처 중일 때에는 capturedOnly 특성의 값을 TRUE로 설정할 수 없습니다.
  3. pureQuery Runtime 특성 traceFiletraceLevel은 전역 pdq.properties 파일에만 지정할 수 있습니다. 전역 특성 파일에 대한 정보는 WebSphere Application Server 환경의 pureQuery Runtime 특성 범위의 내용을 참조하십시오.
  4. 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

피드백