CLI 애플리케이션에서 지원되는 pureQuery 키워드

pureQuery 클라이언트 최적화로 CLI 애플리케이션을 사용하는 경우 애플리케이션 구성 파일에 키워드와 값을 지정해서 pureQuery 클라이언트 최적화를 구성합니다.
다음 표에는 CLI 애플리케이션과 함께 CLI 키워드로 사용할 수 있는 pureQuery Runtime 특성이 나열됩니다. 모든 pureQuery Runtime 특성이 pureQuery 클라이언트 최적화에 사용 가능한 CLI 애플리케이션에서 지원되는 것은 아닙니다.
표 1. pureQuery 클라이언트 최적화에 사용 가능한 CLI에서 지원되는 pureQuery 특성
특성 설명
allowDynamicSQL 애플리케이션이 pureQueryXML 파일에서 캡처되지 않는 SQL문을 동적으로 실행하는지 아니면 캡처되지만 바인드되지는 않는 SQL문을 동적으로 실행하는지를 지정합니다.
capturedOnly pureQueryXML 파일에 있는 SQL문만을 실행할 지 여부를 지정합니다.
captureMode SQL문에 관한 정보를 캡처할지 여부를 지정합니다.
enableDynamicSQLReplacement pureQueryXML 파일에 추가되었으며 원래 명령문 및 대체 명령문이 바인드되지 않은 대체 SQL문을 실행할지 여부를 지정합니다.
executionMode pureQuery 런타임에 의해 이전에 캡처되어 저장된 SQL문을 정적으로 실행할지 여부를 지정합니다.
maxNonParmSQL 캡처할 매개변수화되지 않은 SQL문의 최대수를 지정합니다. 이 옵션은 captureMode의 값이 ON인 경우에만 적용됩니다. captureMode가 OFF인 경우, pureQuery는 이 매개변수를 무시합니다.
propertiesGroupId 데이터베이스에서 작성된 저장소의 런타임 그룹 ID를 지정합니다. pureQuery Runtime은 pureQuery 런타임 구성 및 pureQueryXML 파일 정보를 검색하기 위한 저장소를 지정하는 연결 정보와 런타임 그룹 ID를 사용합니다.
pureQueryXml SQL문 캡처 프로세스에서 작성되거나 그 프로세스의 결과로 이미 존재하는 파일의 이름 및 완전한 경로나 상대 경로를 지정합니다.
pureQueryXmlRepository pureQuery 클라이언트 최적화가 적용된 CLI 애플리케이션에서 사용되는 pureQueryXML 파일 데이터의 저장소를 지정합니다.
repositoryRequired pureQuery 데이터 검색 중 오류가 발생하는 경우 pureQuery 클라이언트 최적화 동작을 지정합니다. pureQueryXmlRepository 특성에 지정된 위치에서 pureQuery 런타임 특성 및 pureQueryXML 데이터를 검색할 수 없는 경우
sqlLiteralSubstitution 리터럴 대체를 수행할지 여부를 지정합니다. pureQuery 런타임에서 SQL문의 리터럴 값을 매개변수 마커로 대체하고 매개변수가 지정된 명령문 버전을 실행합니다.
traceFile 로그를 기록할 파일을 지정합니다. pureQuery 로그 유틸리티가 실행되는 디렉토리에 상대적인 경로 또는 절대 경로를 사용할 수 있습니다.
traceLevel 로그 파일에 기록할 세부사항 레벨을 지정합니다.

사용 참고사항

  • pureQuery Runtime 키워드가 구성 파일에 지정되면 pureQuery Runtime이 유효한 pureQuery 라이센스를 검사합니다. 유효한 pureQuery 라이센스를 찾을 수 없는 경우 pureQuery Runtime이 종료되고 오류 코드 SQL8029N이 리턴됩니다.
  • pureQuery Runtime이 CLI 애플리케이션 환경에서 다음 키워드를 검사합니다. 키워드가 해당 기본값으로 설정되지 않는 경우 pureQuery Runtime은 pureQueryXML 파일이 필요하다고 판별합니다.
    • capturedOnly
    • captureMode
    • enableDynamicSQLReplacement
    • executionMode
  • pureQueryXML 파일이 필수 파일이지만 지정되지 않는 경우 pureQuery Runtime이 오류 CLI0124E 유효하지 않은 인수 값 오류를 표시합니다. SQLSTATE=S1009

피드백