WebSphere Application Server 환경의 pureQuery Runtime 등록 정보 범위

pureQuery Runtime 등록 정보를 설정하여 pureQuery Runtime의 조작을 제어할 수 있습니다. 특정 WebSphere® 위치에 등록 정보를 설정해서 pureQuery Runtime 등록 정보의 범위를 제어할 수 있습니다. 여러 위치에 등록 정보를 설정하면 pureQuery Runtime이 위치를 기반으로 하여 우선순위순으로 사용할 값을 판별합니다.
WebSphere는 위치를 통해 등록 정보의 범위를 판별하고 여러 위치에 등록 정보가 지정된 경우에는 우선순위 순서를 판별합니다. WebSphere의 범위 레벨은 다음 우선순위 순서입니다.
  • 응용프로그램 레벨: pureQuery 등록 정보가 WebSphere 응용프로그램에 적용됩니다. 응용프로그램 레벨의 pureQuery Runtime 등록 정보 설정은 동일한 등록 정보의 전역 레벨 및 데이터 소스 레벨 설정을 모두 겹쳐씁니다. 그렇지 않은 경우에는 pureQuery Runtime 등록 정보가 전역 pureQuery 등록 정보 및 데이터 소스 레벨 pureQuery 등록 정보와 병합됩니다.
  • 데이터 소스 레벨: pureQuery 등록 정보가 데이터 소스에서 작성된 모든 연결에 적용됩니다. 동일한 등록 정보가 데이터 소스 레벨과 전역 레벨 모두에 정의된 경우 데이터 소스 레벨이 전역 레벨 등록 정보 설정을 겹쳐씁니다. 그렇지 않은 경우에는 pureQuery Runtime 등록 정보가 전역 레벨 pureQuery 등록 정보와 병합됩니다.
  • 전역 레벨: pureQuery 등록 정보가 WebSphere Application Server의 모든 응용프로그램에 적용됩니다.

pureQuery Runtime 등록 정보 finalRepositoryProperties를 사용하여 데이터베이스의 저장소나 파일 시스템에서 런타임 등록 정보를 검색할 수 있습니다. 파일 시스템이나 저장소에서 등록 정보를 검색하면 우선순위 순서에 영향이 미칩니다.

파일 시스템 또는 저장소 지정

pureQuery Runtime 등록 정보가 finalRepositoryProperties 등록 정보에 지정된 위치에서 검색하고 설정하기 전에, pureQuery 클라이언트 최적화 및 기존 pureQuery Runtime 등록 정보는 디폴트값으로 재설정됩니다. 데이터 소스 레벨에서 설정된 등록 정보는 저장되지 않습니다. 전역 pureQuery 등록 정보로 검색 및 설정되는 등록 정보는 영향을 받지 않습니다.

다음 예는 pureQuery Runtime 등록 정보 설정이 판별되는 방식을 보여줍니다.
  • 등록 정보가 여러 레벨에서 설정된 경우 레벨은 사용되는 값을 판별합니다. 예를 들어, captureMode 값이 pdq.properties 전역 등록 정보 파일에서 OFF로 설정되고, 응용프로그램에 사용되는 데이터 소스의 데이터 소스 레벨 pdqProperties에서 ON으로 설정되며, 응용프로그램 레벨 pdq.appwide.properties에서 OFF로 설정되면 응용프로그램 레벨 설정이 우선하고 captureMode 등록 정보 값은 OFF로 설정됩니다.
  • pureQuery Runtime 등록 정보가 finalRepositoryProperties 등록 정보로 저장소나 파일 시스템에서 검색되는 경우 전역, 데이터 소스 또는 응용프로그램 레벨의 등록 정보 설정과 무관하게 위치에 지정된 captureMode 등록 정보의 값이 우선합니다. 예를 들어, captureMode가 응용프로그램에 사용되는 데이터 소스의 데이터 소스 레벨 pdqProperties에서 ON으로 설정되고 finalRepositoryProperties 등록 정보도 설정된 경우, pureQuery Runtime은 finalRepositoryProperties 등록 정보에 지정된 위치에서 등록 정보를 검색합니다. captureMode 등록 정보가 검색된 등록 정보에 설정되지 않은 경우에는 captureMode 등록 정보가 디폴트값인 OFF로 설정됩니다. captureMode 등록 정보의 값이 검색된 등록 정보로 설정되면 이 값이 사용됩니다.

WebSphere 환경의 pureQuery Runtime 등록 정보 범위 제어

WebSphere 환경에서는 pureQuery Runtime 등록 정보를 여러 다른 위치에 설정하여 등록 정보의 범위 레벨을 제어합니다. 등록 정보가 여러 위치에 설정되면 위치가 우선순위 순서에도 영향을 줍니다.

전역 범위의 위치

pureQuery Runtime 등록 정보를 등록 정보 파일 pdq.properties에 지정하고 WebSphere JDBC 프로바이더 CLASSPATH에 파일을 포함시키십시오.

pdq.properties 파일을 사용하여 전역 등록 정보를 설정할 때 pdq.properties 파일을 pureQuery JAR 파일과 함께 JDBC 프로바이더 CLASSPATH에 두십시오. JDBC 프로바이더 CLASSPATH에 설정된 등록 정보는 드라이버를 사용하는 모든 응용프로그램에 적용됩니다. 특정 응용프로그램이나 데이터 소스에 적용되는 등록 정보를 여기에 지정하면 안됩니다.

주: SQL문을 동적에서 정적 모드로 실행하도록 pdq.properties 파일을 수정하는 동안 변경사항이 반영되도록 응용프로그램 서버(AS)를 다시 시작해야 합니다. 특정 JDBC 프로바이더를 사용하는 모든 데이터 소스에 등록 정보가 적용되기 때문에 모든 응용프로그램은 동일한 실행 모드에서 실행하며 캡처한 모든 SQL문은 캡처 중 동일한 pureQueryXml 파일로 갑니다.
데이터 소스 레벨 범위의 위치

JDBC Driver 사용자 정의 등록 정보 pdqProperties를 WebSphere 데이터 소스에 지정하십시오.

사용자는 각 데이터 소스에 대한 pureQuery Runtime 등록 정보를 설정할 수 있습니다. 각 데이터 소스에 대한 설정을 서로 독립적으로 유지해야 할 때에는 데이터 소스 레벨이 적합합니다. 예를 들어, 응용프로그램이 구별되는 여러 데이터 소스를 사용하는 경우 각 데이터 소스는 자체 pureQueryXML 파일에서 목표가 되는 SQL을 캡처합니다.

등록 정보가 데이터 소스에 설정되면 이 데이터 소스를 사용 중인 모든 응용프로그램에 등록 정보가 적용됩니다. 따라서 응용프로그램이 데이터 소스를 공유할 때 캡처한 SQL문은 모든 응용프로그램의 공통 파일에서 캡처됩니다.

등록 정보의 값이 변경될 때마다 응용프로그램 서버(AS)가 새 값을 사용할 수 있도록 응용프로그램 서버를 다시 시작해야 합니다.

응용프로그램 레벨 범위의 위치
응용프로그램 CLASSPATH의 다음 등록 정보 파일 중 하나 또는 둘 모두를 사용하여 pureQuery Runtime 등록 정보를 응용프로그램 레벨 범위에서 사용하십시오.
  • pdq.appwide.properties
  • pdq.DSName.properties

    DSName은 데이터 소스에 설정된 WebSphere DB2® Universal JDBC 드라이버 사용자 정의 등록 정보 dataSourceName의 값입니다.

pdq.appwide.properties 파일은 응용프로그램별 pureQuery 등록 정보를 지정합니다. 이 파일에 지정된 모든 등록 정보 값은 응용프로그램이 사용하는 모든 데이터 소스에 적용됩니다.

pdq.DSName.properties 파일은 응용프로그램의 데이터 소스별 등록 정보를 지정합니다. 이 파일에 지정된 등록 정보는 응용프로그램이 사용하는 특정 데이터 소스에만 적용됩니다. DSName은 데이터 소스의 WebSphere 사용자 정의 등록 정보 dataSourceName의 문자열 값입니다. 이 사용자 정의 등록 정보는 WebSphere 사용자 정의 등록 정보 pdqProperties를 설정하는 데 사용된 단계와 유사한 단계를 사용하여 설정됩니다.

데이터 소스 이름 DSName을 사용하는 응용프로그램의 경우, pdq.DSName.properties에 지정된 등록 정보가 pdq.appwide.properties에 지정된 등록 정보보다 우선합니다.

이 pureQuery Runtime 등록 정보를 WebSphere 설치의 다음 중 한 위치에 둘 수 있습니다.
  • 웹 응용프로그램의 WEB-INF/classes 아래에
  • WEB-INF/lib 디렉토리 아래에 JAR 파일로
  • 설치된 응용프로그램 디렉토리 바로 아래에
응용프로그램에 웹 모듈이 있으면 첫 번째 두 옵션만 실행 가능합니다. EJB 응용프로그램의 경우에는 위에 언급된 세 가지 위치 중 어느 위치나 사용할 수 있습니다.

응용프로그램이 pdq.appwide.properties 또는 pdq.dsName.properties 파일과 같은 응용프로그램별 등록 정보 파일을 사용하는 경우, 등록 정보가 변경될 때 새 등록 정보가 적용되게 하려면 WebSphere 연결 풀을 제거하고 응용프로그램 서버(AS) 대신 응용프로그램을 다시 시작하여 새 등록 정보 값을 적용해야 합니다.

위치는 파일 시스템 또는 저장소

pureQuery Runtime 등록 정보 finalRepositoryProperties로 데이터베이스의 저장소 또는 파일 시스템을 지정합니다. 등록 정보를 전역 레벨, 데이터 소스 레벨 또는 응용프로그램 레벨에서 지정할 수 있습니다.

pureQuery Runtime은 finalRepositoryProperties 등록 정보에 지정된 위치에서 등록 정보를 검색할 때 다음 규칙을 적용합니다.
  • finalRepositoryProperties에서 로드되는 등록 정보는 로드하는 응용프로그램에만 영향을 줍니다.
  • pureQuery 클라이언트 최적화 또는 pureQuery Runtime에 유효하지 않은 finalRepositoryProperties에서 로드되는 등록 정보는 무시되고 로깅이 사용되면 로그됩니다. 이 동작은 데이터 소스 레벨 또는 응용프로그램 레벨 등록 정보와 동일합니다.
  • 등록 정보 finalRepositoryProperties의 값은 초기 finalRepositoryProperties 등록 정보에 지정된 위치에서 검색되는 경우 무시됩니다. pureQuery Runtime은 finalRepositoryProperties 등록 정보로 복수 경로 재지정 레벨을 지원하지 않습니다.
  • finalRepositoryProperties 등록 정보를 지정하는 것 외에, pureQuery Runtime 등록 정보 propertiesGroupId를 지정하여 응용프로그램이 pureQuery 데이터를 검색하는 데 사용하는 데이터베이스에 작성된 저장소에 런타임 그룹 버전을 지정합니다.

    propertiesGroupId 등록 정보의 값은 데이터베이스에 작성된 저장소에 사용되지 않으면 무시됩니다. 저장소가 사용 중일 때에는 경로 재지정된 등록 정보 내에서 propertiesGroupId 등록 정보의 값을 변경할 수 없습니다.

  • finalRepositoryProperties 등록 정보에 지정된 위치에서 검색되는 pureQuery Runtime 등록 정보는 propertiesRefreshInterval 등록 정보가 위치에서 검색된 등록 정보 중 하나이고 양수 값으로 설정된 경우에만 자동 등록 정보 새로 고침에 사용됩니다. 각 응용프로그램에는 finalRepositoryProperties에서 검색되는 등록 정보에 정의된 다른 propertiesRefreshInterval이 있을 수 있습니다.

pureQuery Runtime repositoryRequired 등록 정보는 파일 시스템이나 저장소를 사용할 때 pureQuery Runtime의 동작을 제어합니다. WebSphere 위치 pureQuery에 등록 정보를 지정하여 pureQuery Runtime 동작을 제어합니다. repositoryRequired 등록 정보를 검색된 등록 정보 중 하나로 설정해서 repositoryRequired 등록 정보의 값을 겹쳐쓸 수 있습니다.


피드백