repositoryRequired 특성

pureQuery 데이터를 검색 또는 쓰는 중에 오류가 발생하는 경우 pureQuery 클라이언트 최적화 동작을 지정합니다. pureQuery 런타임 특성 및 pureQueryXML 데이터를 finalRepositoryProperties 특성으로 지정된 위치에서 검색할 수 없거나 캡처된 SQL을 저장하는 저장소에 액세스할 수 없는 경우입니다.

pureQuery 클라이언트 최적화를 사용하는 Java 애플리케이션의 경우 이 특성은 finalRepositoryProperties 특성도 지정되는 경우에만 인식되며 그렇지 않은 경우 무시됩니다. finalRepositoryProperties 특성은 pureQuery 클라이언트 최적화를 사용하는 CLI 애플리케이션에 지원되지 않습니다.

이 특성은 다음과 같은 값을 가질 수 있습니다.

atStartup
애플리케이션 시작 시 finalRepositoryProperties 특성으로 지정된 위치가 필수임을 지정합니다. pureQuery 특성이 사용 불가능하거나 읽기 오류가 발견되는 경우 예외가 발생합니다.
forOutput
저장소에 첫 번째 캡처된 SQL 데이터 쓰기가 성공해야 함을 지정합니다. 저장소가 사용 불가능하거나 쓰기 오류가 발견되는 경우 예외가 발생합니다. 애플리케이션 시작 후 저장소가 사용 불가능해지는 경우 로깅이 사용 가능하면 오류가 로그됩니다. 애플리케이션이 계속 실행되고 캡처된 SQL 쓰기가 다음 스케줄 시간에 시도됩니다.

값은 pureQuery 클라이언트 최적화를 사용하는 CLI 애플리케이션에 지원되지 않습니다.

atStartupAndForOutput
atStartupforOutput 값이 모두 사용 가능함을 지정합니다.

값은 pureQuery 클라이언트 최적화를 사용하는 CLI 애플리케이션에 지원되지 않습니다.

no
애플리케이션 시작 시 finalRepositoryProperties 특성으로 지정된 위치가 사용 불가능한 경우 기본 동작을 지정합니다. 다음 목록은 기본 동작을 설명합니다.
  • 애플리케이션이 기본 pureQuery 클라이언트 최적화 및 pureQuery 런타임 구성을 사용하여 실행됩니다. 애플리케이션이 동적 SQL을 실행합니다.
  • 로깅이 사용 가능한 경우, 저장소에 문제점이 있음을 표시하는 메시지가 로그됩니다.
  • 타이머 스레드를 작성할 수 있는 경우, 10분마다 pureQuery 런타임 특성 및 pureQueryXML 데이터 검색이 시도됩니다. 정보가 검색되는 경우, pureQuery 클라이언트 최적화는 검색된 pureQuery 런타임 특성 및 pureQueryXML 데이터를 사용합니다.
  • pureQuery 클라이언트 최적화가 캡처된 SQL 데이터를 저장소에 저장하도록 구성되고 저장소가 사용 불가능하거나 쓰기 오류가 발견되는 경우, 저장소에 문제점이 있음을 표시하는 메시지가 로그됩니다. 저장소에 캡처된 SQL 데이터 쓰기가 다음 스케줄 시간에 시도됩니다.

사용 참고사항

다음 목록에는 repositoryRequired 특성 사용에 대한 정보가 포함되어 있습니다.

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는 값 atStartupno만 지원합니다.
  • repositoryRequired 키워드를 지정하는 경우 키워드 pureQueryXmlRepositorypropertiesGroupId도 지정해야 합니다.
  • repositoryRequired 값이 no로 설정되고 시작 시 pureQueryXmlRepository 키워드로 지정된 저장소 위치를 사용할 수 없는 경우 SQL문은 기본 pureQuery Runtime 설정으로 동적으로 실행됩니다. sqlLiteralSubstitution 키워드를 제외하고 모든 pureQuery Runtime 키워드 값은 해당 기본값으로 설정됩니다. 구성 파일의 sqlLiteralSubstitution 세트 값이 보유됩니다.
  • 저장소에서의 pureQueryXml 캡처 파일 검색이 실패하는 경우 SQL 오류 CLI00202E가 리턴됩니다.

피드백