pureQuery 데이터를 검색 또는 쓰는 중에 오류가 발생하는 경우
pureQuery 클라이언트 최적화 동작을 지정합니다. pureQuery
런타임 특성 및 pureQueryXML 데이터를 finalRepositoryProperties 특성으로
지정된 위치에서 검색할 수 없거나 캡처된 SQL을 저장하는 저장소에 액세스할 수 없는 경우입니다.
pureQuery 클라이언트 최적화를 사용하는
Java 애플리케이션의 경우 이 특성은
finalRepositoryProperties 특성도 지정되는 경우에만 인식되며
그렇지 않은 경우 무시됩니다. finalRepositoryProperties 특성은
pureQuery 클라이언트 최적화를 사용하는
CLI 애플리케이션에 지원되지 않습니다.
이 특성은
다음과 같은 값을 가질 수 있습니다.
- atStartup
- 애플리케이션 시작 시 finalRepositoryProperties 특성으로 지정된 위치가
필수임을 지정합니다. pureQuery 특성이 사용 불가능하거나
읽기 오류가 발견되는 경우 예외가 발생합니다.
- forOutput
- 저장소에 첫 번째 캡처된 SQL 데이터 쓰기가 성공해야 함을
지정합니다. 저장소가 사용 불가능하거나 쓰기 오류가
발견되는 경우 예외가 발생합니다. 애플리케이션 시작 후
저장소가 사용 불가능해지는 경우 로깅이 사용 가능하면 오류가 로그됩니다.
애플리케이션이 계속 실행되고 캡처된 SQL 쓰기가 다음 스케줄 시간에
시도됩니다.
값은 pureQuery 클라이언트 최적화를 사용하는
CLI 애플리케이션에 지원되지 않습니다.
- atStartupAndForOutput
- atStartup 및 forOutput 값이 모두
사용 가능함을 지정합니다.
값은 pureQuery 클라이언트 최적화를 사용하는
CLI 애플리케이션에 지원되지 않습니다.
- no
- 애플리케이션 시작 시 finalRepositoryProperties 특성으로 지정된 위치가
사용 불가능한 경우 기본 동작을 지정합니다. 다음 목록은 기본 동작을
설명합니다.
- 애플리케이션이 기본 pureQuery 클라이언트 최적화 및
pureQuery 런타임 구성을 사용하여 실행됩니다. 애플리케이션이
동적 SQL을 실행합니다.
- 로깅이 사용 가능한 경우, 저장소에 문제점이 있음을 표시하는 메시지가
로그됩니다.
- 타이머 스레드를 작성할 수 있는 경우, 10분마다
pureQuery 런타임 특성 및 pureQueryXML 데이터 검색이 시도됩니다.
정보가 검색되는 경우, pureQuery 클라이언트 최적화는
검색된 pureQuery 런타임 특성 및 pureQueryXML 데이터를 사용합니다.
- pureQuery 클라이언트 최적화가 캡처된
SQL 데이터를 저장소에 저장하도록 구성되고 저장소가 사용 불가능하거나
쓰기 오류가 발견되는 경우, 저장소에 문제점이 있음을 표시하는
메시지가 로그됩니다. 저장소에 캡처된 SQL 데이터 쓰기가
다음 스케줄 시간에 시도됩니다.
사용 참고사항
다음 목록에는
repositoryRequired 특성 사용에 대한 정보가 포함되어 있습니다.
- 기본 pureQuery 클라이언트 최적화 동작을 겹쳐쓰려면
repositoryRequired 특성을
애플리케이션 시작 pureQuery 특성의 일부로 지정하십시오.
- repositoryRequired 특성을 저장소에서 검색되는
특성으로 지정하는 경우, 특성 값은 현재 특성 값을 대체합니다.
- 애플리케이션이 정적 SQL을 실행하거나 SQL 대체로 실행해야 하는 경우에는
atStartup 또는 atStartupAndForOutput
특성 값을 지정하십시오.
- 다음과 같은 환경을 가정합니다.
- 애플리케이션 시작 시 pureQuery 런타임 특성 및 pureQueryXML을 포함하는 저장소 및
필요한 경우 캡처된 SQL 데이터를 저장하는 저장소가 사용 가능합니다.
- pureQuery 특성 및 pureQueryXML 데이터가 검색되고
처리됩니다.
- propertiesRefreshInterval 특성이 사용 가능하고
0보다 큰 값으로 설정됩니다.
다음 목록은 propertiesRefreshInterval 특성와
repositoryRequired 특성 간의 상호 작용을 설명합니다.
- 새로 고침 중에 pureQuery 특성 및 pureQueryXML 데이터를
저장하는 위치가 사용 불가능한 경우, 오류가 로그되고
애플리케이션이 시작 시 검색된 pureQuery 특성 및 pureQueryXML을
사용하여 실행됩니다. 새로 고침 간격마다
pureQuery 클라이언트 최적화는 pureQuery 데이터 검색을 시도합니다.
- 새로 고침 중에 스토리지 위치에 있는 pureQuery 특성 또는
pureQueryXML 데이터에 대한 업데이트사항이 발견되는 경우, 업데이트된 데이터가
검색됩니다. 검색 중에 오류가 발생하는 경우, 오류가 로그되고
데이터가 무시됩니다. 다음 새로 고침 중에 pureQuery 데이터
검색이 시도됩니다.
- 새로 고침 중에 업데이트된 pureQuery 데이터가 검색되었지만
특성이 유효하지 않거나 pureQueryXML이 올바르지 않은 경우,
오류가 로그되고 검색된 데이터는 무시됩니다. 다음 새로 고침 중에
pureQuery 데이터 검색이 시도됩니다.
- cmx.controllerDiscoveryInterval 특성의 값이
다음 환경에서 -2로 설정되면 타이머 스레드 작성이 금지되고
propertiesRefreshInterval 특성이
무시됩니다.
- DB2® z/OS® Java 스토어드
프로시저
- CICS®
특성 값이 -2로 설정되면
Performance Expert Extended Insight의 자동 발견이 사용 불가능하게 설정됩니다.
이러한 환경에서는
애플리케이션이 동적 SQL을 사용하여 실행됩니다. 클라이언트 최적화가
SQL 데이터를 캡처하도록 구성되고 캡처된 SQL 데이터를 쓸 수 없는 경우에는
오류가 로그되고 캡처된 SQL 쓰기는 나중에 시도됩니다.
DB2 CLI
및 IBM Data Server Driver
사용법 참고
DB2 CLI(Call Level Interface) 또는
IBM® Data Server Driver를
pureQuery 런타임에 사용하는 경우 pureQuery Runtime 특성을 구성 키워드로 사용할 수 있습니다.
- IBM CLI 키워드 구문
- repositoryRequired = atStartup | no
- IBM Data Server Driver
구성 구문
- <parameter name="repositoryRequired" value="atStartup | no"
/>
- .NET 연결 문자열 키워드에 대한 해당 IBM
Data Server Provider
- N/A
DB2 CLI 사용법
참고
pureQueryXmlRepository 키워드가
pureQuery 클라이언트 최적화를 사용하는 CLI 애플리케이션과 함께 지정되는 경우 다음 사용 정보가 적용됩니다.
- CLI 애플리케이션의 경우 pureQueryXML 파일 데이터만
저장소에서 검색됩니다. pureQuery
Runtime 설정은 저장소에서 검색되지 않습니다. 구성 파일에서 지정된
pureQuery Runtime 설정이 사용됩니다.
- repositoryRequired는 값 atStartup 및 no만 지원합니다.
- repositoryRequired 키워드를 지정하는 경우
키워드 pureQueryXmlRepository 및 propertiesGroupId도
지정해야 합니다.
- repositoryRequired 값이 no로 설정되고
시작 시 pureQueryXmlRepository 키워드로 지정된 저장소 위치를
사용할 수 없는 경우 SQL문은 기본 pureQuery Runtime 설정으로
동적으로 실행됩니다. sqlLiteralSubstitution
키워드를 제외하고 모든 pureQuery Runtime 키워드 값은 해당 기본값으로
설정됩니다. 구성 파일의
sqlLiteralSubstitution 세트 값이 보유됩니다.
- 저장소에서의 pureQueryXml 캡처 파일 검색이 실패하는 경우
SQL 오류 CLI00202E가 리턴됩니다.