시나리오: WebSphere Application Server에 사용자 정의 데이터 소스 특성 설정

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

사용자 정의 데이터 소스 특성 pdqPropertiesdataSourceName을 지정할 때는 데이터 소스에 대한 pureQuery Runtime 특성을 지정합니다.

주: pdqProperties 문자열을 사용하여 데이터 소스에 pureQuery Runtime 특성을 지정할 경우 사용자 정의 데이터 소스 특성 dataSourceName보다 이 특성이 우선 적용됩니다.

프로시저

WebSphere Application Server에 사용자 정의 데이터 소스 특성을 설정하려면 다음을 수행하십시오.

  1. 사용자 정의 데이터 소스 특성 pdqProperties를 데이터 소스에 설정하십시오.

    관리 콘솔에서 사용자 정의 특성 분할 영역으로 이동하십시오.

    JDBC 프로바이더 > DB2 Universal JDBC Driver Provider > 데이터 소스 > DB2 Universal JDBC Driver DataSource > 사용자 정의 특성.

    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 특성에 지정된 위치에서 검색한 새로 고침 간격이 적용됩니다.

  2. WebSphere 사용자 정의 데이터 소스 특성 dataSourceName을 설정하십시오.

    사용자 정의 특성 패널에서 사용자 정의 DB2 Universal JDBC 특성 dataSourceName을 작성하십시오. 데이터 소스를 식별하는 적절한 문자열로 값을 설정하십시오. 시나리오에서는 값이 nobleDS로 설정됩니다.

  3. 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 데이터를 캡처해서 저장소에 데이터를 저장합니다.


피드백