pureQuery Runtime 특성을 데이터 소스 레벨에서
설정합니다. 저장소에서 검색된 pureQuery Runtime
특성도 데이터 소스 레벨에서 설정됩니다. 애플리케이션을 다시
시작하면 pureQuery Runtime이 애플리케이션에서 발행된 SQL문을 캡처합니다.
시작하기 전에
WebSphere® Application
Server가 동적 애플리케이션을 실행 중인지 확인하십시오. 애플리케이션은
DB2® 프로바이더에 사용 가능한
JNDI 이름 jdbc/nobleDS의 데이터 소스를 사용하고 있습니다.
이 태스크 정보
데이터 소스에 대한 WebSphere
JDBC 프로바이더 사용자 정의 특성을 작성합니다. pureQuery Runtime
및 IBM® Data
Server Driver for JDBC and SQLJ에 특성이 사용됩니다.
pureQuery Runtime의
사용자 정의 특성
pdqProperties는
시나리오: pureQuery Runtime의 저장소 작성 및 구성 태스크에서 작성한
저장소를 가리킵니다. DB2 드라이버의
dataSourceName 특성은 트랜잭션 데이터베이스를
데이터 소스로 지정합니다. 다음 표에는
WebSphere 특성와 값이
나열됩니다.
표 1. WebSphere 사용자 정의
특성WebSphere 사용자 정의
데이터 소스 특성 이름 |
값 |
pdqProperties |
finalRepositoryProperties(ds://jdbc/nobleDS),
propertiesGroupId(testApp), repositoryRequired(atStartup), propertiesRefreshInterval(2) |
dataSourceName |
nobleDS |
사용자 정의 데이터 소스
특성 pdqProperties 및 dataSourceName을 지정할 때는
데이터 소스에 대한 pureQuery Runtime 특성을 지정합니다.
주: pdqProperties
문자열을 사용하여 데이터 소스에 pureQuery Runtime 특성을 지정할 경우
사용자 정의 데이터 소스 특성 dataSourceName보다
이 특성이 우선 적용됩니다.
프로시저
WebSphere Application Server에
사용자 정의 데이터 소스 특성을 설정하려면 다음을 수행하십시오.
- 사용자 정의 데이터 소스 특성 pdqProperties를
데이터 소스에 설정하십시오.
관리 콘솔에서 사용자 정의 특성 분할 영역으로
이동하십시오.
.
pdqProperties라는 특성을 작성하십시오.
pureQuery Runtime 특성의 사용자 정의 특성을 지정하려면
다음 값을 설정하십시오.
finalRepositoryProperties(ds://jdbc/nobleDS),
propertiesGroupId(testApp), repositoryRequired(atStartup), propertiesRefreshInterval(2)
WebSphere 사용자 정의
특성은 다음 pureQuery Runtime 특성을 지정합니다.
- finalRepositoryProperties
- 이 값은 애플리케이션에 사용되는 pureQuery Runtime 특성을 저장하는
저장소의 위치를 지정합니다.
시나리오에서는 값이 데이터 소스 ds://jdbc/nobleDS입니다. 저장소 데이터베이스는
트랜잭션 데이터베이스와 동일합니다.
- propertiesGroupId
- 이 값은 애플리케이션의 pureQuery Runtime 특성 및 pureQueryXML
데이터를 저장하는 런타임 그룹 ID를 지정합니다. propertiesGroupId의
값은 데이터베이스의 지정된 저장소에 정의된 런타임 그룹 ID이어야
합니다. 시나리오에서는
데이터 소스 jdbc/nobleDS에 지정된 데이터베이스에 저장소가
있습니다. propertiesGroupId
값은 시나리오: pureQuery Runtime의 저장소 작성 및 구성에서 작성한
런타임 그룹의 ID입니다.
- repositoryRequired
- 이 값은 저장소가 사용 불가능한 경우 pureQuery Runtime 동작을
지정합니다. 시나리오에서는 값이 atStartup입니다.
저장소는 애플리케이션 시작 시 저장소에서
pureQuery Runtime 특성와 pureQueryXML 데이터를 읽을 때 필요합니다.
저장소가 사용 불가능하거나 읽기 오류가 발견되면
애플리케이션에 예외가 발생합니다. 다음은 repositoryRequired
특성의 기타 허용된 값입니다.
- forOutput 값은 pureQuery Runtime이 저장소에
처음으로 쓰기를 시도할 때 캡처한 SQL 데이터를 저장하는 저장소가 사용 불가능한 경우
애플리케이션에 예외가 발생함을 지정합니다.
- atStartupAndForOutput 값은 atStartup 및 forOutput
모두에 대한 pureQuery Runtime 동작이 사용 가능함을
지정합니다.
repositoryRequired 특성이
지정되지 않고 finalRepositoryProperties 옵션에 지정된
위치가 사용 불가능한 경우 pureQuery Runtime은 저장소가 사용 가능하게 될 때까지
SQL문을 동적으로 실행합니다.
팁: SQL문을 정적으로
실행하기 위해 또는 다양한 SQL 대체로 SQL문을 실행하기 위해 애플리케이션이 필요하면
repositoryRequired 특성을 atStartup 또는 atStartupAndForOutput
값으로 지정해야 합니다.
- propertiesRefreshInterval
- 이 값은 finalRepositoryProperties 특성에
지정된 위치에 저장되는 pureQueryXML 데이터 또는 pureQuery Runtime 특성의
갱신사항을 점검하는 대기 간격(분)을 지정합니다.
pureQuery Runtime은 propertiesRefreshInterval 특성이
검색된 특성 중 하나이고 특성의 값이 양의 정수 값인 경우에만
특성의 갱신사항을 점검합니다.
주: pureQuery Runtime이 먼저
특성을 검색한 후에 새로 고침 간격을 변경할 수 있습니다.
propertiesRefreshInterval
특성을 애플리케이션 시작 시에 사용되는 특성으로 설정할 수
있습니다.
finalRepositoryProperties
특성에 지정된 위치에서 검색되는 특성으로 지정할 수도 있습니다.
시작 시
저장소가 필요하지 않으면 저장소 사용 가능성에 따라 다른
새로 고침 간격을 지정할 수 있습니다. 애플리케이션이 지정한
새로 고침 간격은 저장소가 지원될 때까지
적용됩니다. 저장소가 지원되면 finalRepositoryProperties
특성에 지정된 위치에서 검색한 새로 고침 간격이
적용됩니다.
- WebSphere 사용자 정의
데이터 소스 특성 dataSourceName을 설정하십시오.
사용자 정의 특성
패널에서 사용자 정의 DB2 Universal JDBC 특성 dataSourceName을 작성하십시오.
데이터 소스를 식별하는 적절한 문자열로 값을 설정하십시오.
시나리오에서는 값이 nobleDS로 설정됩니다.
- WebSphere Application
Server를 다시 시작하십시오.
사용자 정의 특성에 지정된 데이터 소스 및 프로바이더 CLASSPATH의
변경사항과 함께 애플리케이션 서버(AS)가 다시 시작됩니다.
결과
WebSphere JDBC
프로바이더 사용자 정의 특성 pdqProperties가
WebSphere에서
데이터 소스에 대해 인식되면 이 데이터 소스에서 작성된 모든 연결이
pureQuery 클라이언트 최적화로 사용
가능하게 됩니다. pureQuery Runtime 특성 finalRepositoryProperties는
pureQuery Runtime 특성이 저장되는 저장소의 위치를
지정합니다. pureQuery Runtime 특성 propertiesGroupId는
저장소의 런타임 그룹을 표시합니다.
pureQuery
특성이 저장소에서 검색되고 propertiesRefreshInterval
특성이 저장소에서 검색되므로, 애플리케이션 서버(AS)를 다시 시작하지 않고도
pureQuery 구성 정보, pureQuery 특성 및 pureQueryXML 데이터를
갱신할 수 있습니다. 애플리케이션은
정보의 갱신사항을 점검하며 갱신된 정보를 검색하고 사용합니다.
팁: 둘 이상의
애플리케이션이 데이터 소스를 공유하는 경우에는 pureQuery Runtime
특성을 애플리케이션 레벨에서 대체할 수 있습니다.
다음에 수행할 작업
다음 태스크에서는 WebSphere
애플리케이션을 실행하여 SQL문을 실행합니다.
pureQuery Runtime은 SQL문 및 연관된 SQL 데이터를 캡처해서 저장소에
데이터를 저장합니다.