워크벤치는 wsdb2gen 명령을 실행하여 pureQueryXML
파일을 작성하고, SQL문을 바인드하며, JPA 응용프로그램 실행 시 정적으로
명령문을 실행할 수 있는 기능을 제공합니다.
시작하기 전에
시스템이 하드웨어 및
소프트웨어 요구사항을 충족하는지 확인하십시오. Optim™ pureQuery Runtime에 대한 시스템 요구사항을 참조하십시오.
응용프로그램이 워크벤치의 JPA 프로젝트에
있어야 합니다. 응용프로그램을 JPA 프로젝트로 임포트하거나 워크벤치에서
응용프로그램을 개발할 수도 있습니다. 응용프로그램을 개발하는 경우
http://www.eclipse.org/webtools/dali에서
Eclipse Dali JPA 도구 사용 설명서를 참조하십시오.
Apache OpenJPA 사용 설명서는 http://openjpa.apache.org/documentation.html의
"OpenJPA Documentation" 페이지를 참조하십시오.
바인드 조작을 수행하기 전에
다음 전제조건이 충족되는지 확인하십시오.
- pureQuery StaticBinder 유틸리티를 호출하는 사용자의 특권 세트는
다음 권한 중 하나를 포함해야 합니다.
- SYSADM 권한
- DBADM 권한
- 패키지가 존재하지 않는 경우 BINDADD 특권 및 다음 특권 중 하나를
포함해야 합니다.
- CREATEIN 특권
- z/OS®용 DB2®: 해당 콜렉션 또는 모든 콜렉션의
PACKADM 권한
- Linux®, UNIX® 및 Windows®용 DB2 데이터베이스: 패키지의 스키마 이름이 존재하지 않는 경우
데이터베이스의 IMPLICIT_SCHEMA 권한
- z/OS용 DB2: 패키지가 존재하는 경우
패키지의 BIND 특권
- Linux, UNIX 및 Windows용 DB2 데이터베이스: 패키지가 존재하는 경우
- 스키마의 ALTERIN 특권
- 패키지의 BIND 특권
- Linux, UNIX 및
Windows용 DB2: 또한 사용자는
응용프로그램의 모든 정적 SQL문을 컴파일하는 데 필요한 모든 특권이
필요합니다. 그룹에 권한 부여된 특권은 정적 명령문의 권한 부여 점검에
사용되지 않습니다. 사용자에게 SYSADM 권한은 있지만 바인드를 완료할 수 있는 명시적 특권은
없는 경우, DB2 데이터베이스 관리 프로그램이 명시적 DBADM 권한을
자동으로 부여합니다.
이 태스크 정보
이 태스크의 단계는 WebSphere® Application
Server 7.0용 문서에 있는 다음 주제의 4단계에 자세히 설명되어 있습니다.
프로시저
Websphere Application Server
7.0을 사용하는 JPA 응용프로그램에서 SQL문의
정적 실행을 구성하려면 다음을 수행하십시오.
- JPA 프로젝트에서 pureQuery 지원을 사용하도록 설정하십시오. JPA 프로젝트가 pureQuery를 지원하도록 구성해야 합니다.
- JPA 프로젝트를 마우스 오른쪽 단추로
누르고 pureQuery 지원 추가를 선택하십시오. pureQuery 지원 추가 마법사의
단계를 따르십시오. 마법사의 제어사항에 대한 정보를 보려면
마법사의 하단 왼쪽 구석에 있는
을 누르십시오.
도움말이 표시되지 않으면 pureQuery 지원 추가
페이지에서 제어사항을 선택한 후
을 다시 누르십시오.
완료를 누르면,
워크벤치는 JPA 프로젝트에서 pureQueryFolder 폴더를
작성합니다. 이 폴더에는 Default.bindProps 파일이 있습니다.
pureQuery가 아닌 API 응용프로그램에 있는
SQL문의 캡처 및 바인딩을 사용하지 않도록 설정하고 pureQuery에 대한 지원을
JPA 프로젝트에서 제거하려면, 프로젝트를 마우스 오른쪽 단추로 누르고
pureQuery > pureQuery
지원 제거를 선택하십시오.
- com.ibm.ws.jpa.jar 파일을 프로젝트로 임포트하고
빌드 경로에 추가하십시오. 파일은 WebSphere Application Server 7.0과 함께 제공됩니다.
- JPA 프로젝트에서 persistence.xml 파일을 마우스 오른쪽 단추로
누르고 pureQueryXML 파일 생성을 선택하여
JPA 응용프로그램에 대한 pureQueryXML 파일을 작성하십시오. 이 단계는 wsdb2gen 명령을 수동으로 실행하는 것을 대신합니다.
- 옵션: pureQueryXML 파일에 있는 SQL문 및 해당 정보를
보십시오.
프로젝트의 패키지 탐색기 또는 프로젝트의 파일에 프로젝트 폴더를 선택하면
SQL 아웃라인 보기가 채워집니다. 보기가 열려 있지 않은 경우, 프로젝트를 마우스 오른쪽 단추로 누르고 pureQuery > SQL 아웃라인 표시를 선택합니다.
- 데이터베이스 페이지에서는
SQL문이 참조하는 데이터베이스 오브젝트를 볼 수 있습니다.
- Java 페이지에서는 캡처된 SQL문을 포함하는 Java 파일을
볼 수 있습니다. 프로젝트가 Java 소스
파일을 포함하는 경우, SQL문을 더블 클릭하여 Java 편집기에서
해당 소스 파일을 열 수 있습니다.
- SQL 페이지에서는 워크벤치가 캡처된 SQL문에 제안하는
DB2
패키지를 볼 수 있습니다. 이 경우 바인드 조작을 아직 수행하지 않았기 때문에
보기에는 바인드를 수행할 때 워크벤치에서 작성할 패키지만 표시됩니다.
- 옵션: 응용프로그램에 맞게
pureQueryXML 파일을 편집하십시오.
- StaticBinder 유틸리티가 캡처된 SQL문을
DB2 패키지에 바인드하는 방법을 판별하는 옵션을 지정하여
Default.bindProps 파일을 편집하십시오.
- 다음 단계 중 하나를 수행하여 캡처된 SQL문을
바인드하십시오.
- pureQueryFolder 폴더에서 개별 pureQueryXML 파일을 마우스 오른쪽 단추로 누르고
바인드를 선택하십시오.
- 프로젝트 폴더를 마우스 오른쪽 단추로 누르고 pureQuery > 응용프로그램
바인드를 선택하십시오. 이 방법을 사용하여 모든 pureQueryXML 파일의 SQL을
한 번에 바인드할 수 있습니다.
연결 선택 창이 열리고
사용하려는 DB2 데이터베이스를
선택할 수 있습니다. Java 프로젝트와
연관되지 않은 데이터베이스를 선택할 수 있습니다.
주의: 오프라인으로 작업 중인 경우 바인드 조작을 수행할 수 없습니다.
바인드하려는 DB2 데이터베이스에 연결되어 있어야 합니다.
이 단계 후 pureQueryXML 파일에서 추가 SQL문을 캡처하면
이들 파일의 바인드 조작을 재실행해야 합니다.
- 다음 단계 중 하나를 수행하여 캡처된 SQL문을
바인드하십시오.
- pureQueryFolder 폴더에서 개별 pureQueryXML 파일을 마우스 오른쪽 단추로 누르고
바인드를 선택하십시오.
- 프로젝트 폴더를 마우스 오른쪽 단추로 누르고 pureQuery > 응용프로그램
바인드를 선택하십시오. 이 방법을 사용하여 모든 pureQueryXML 파일의 SQL을
한 번에 바인드할 수 있습니다.
연결 선택 창이 열리고
사용하려는 DB2 데이터베이스를
선택할 수 있습니다. Java 프로젝트와
연관되지 않은 데이터베이스를 선택할 수 있습니다.
주의: 오프라인으로 작업 중인 경우 바인드 조작을 수행할 수 없습니다.
바인드하려는 DB2 데이터베이스에 연결되어 있어야 합니다.
이 단계 후 pureQueryXML 파일에서 추가 SQL문을 캡처하면 이들 파일의 바인드 조작을 재실행해야 합니다.
- 옵션: DB2 패키지와 패키지에 포함된
SQL문을 보십시오.
원하는 DB2 패키지를 작성했는지 확인하려면 프로젝트 폴더를 선택하고 SQL 아웃라인 보기의 SQL 페이지를 봅니다.
패키지의 등록 정보를 변경하려면 다음을 수행하십시오.
- Default.bindProps 파일을 편집하십시오.
- 바인드 조작을 반복하십시오.
응용프로그램에서 계속 Java 소스 또는
SQL문을 편집할 수 있습니다. 편집한 후에는
pureQueryXML 파일을 삭제하고 다시 생성하십시오. 그런 다음 바인드 조작을 다시
수행하십시오.
- 응용프로그램을 실행하여 테스트하십시오. 응용프로그램에 대한 SQL문이 드라이버의 패키지가 있는 콜렉션에
바인드되어 있는 경우, 이 단계를 수행할 필요가 없습니다.
다음에 수행할 작업
SQL 아웃라인 보기를 사용하여
SQL문에 대해 발생할 수 있는 문제점을 해결할 수 있습니다. SQL문이나
응용프로그램의 다른 측면을 수정하는 경우 pureQueryXML 파일을 다시 생성하고
DB2 패키지를 다시 작성해야 합니다.
JAR 파일에서 응용프로그램을 전개하려는 경우:
JAR 파일에서 응용프로그램을 전개하기 전에 바인드하려는 SQL문을 포함하는 전체 pureQueryXML 파일의
항목이 Default.bindProps 파일에 들어 있는지 확인해야 합니다.
응용프로그램을 전개하는 데이터베이스의 명령행에서 실행해야 하는
pureQuery StaticBinder 유틸리티는 Default.bindProps 파일에 나열된
pureQueryXML 파일에 대해서만 작용합니다.
파일을 추가하려면
다음을 수행하십시오.
- 프로젝트의 pureQueryFolder 폴더에서 Default.bindProps 파일을
마우스 오른쪽 단추로 누르고 pureQuery > 항목 추가
또는 제거를 선택하십시오.
- 항목 추가 또는 제거 창에서 모든 필수 pureQueryXML 파일을
추가하십시오.