pcandme's blog

이클립스에서 오라클 데이터베이스의 연결을 설정하는 방법이다. 이클립스와 오라클 데이터베이스의 버전은 다음과 같다.

- 이클립스: Eclipse IDE for Java EE Developers, Version: 3.4.2 Ganymede
- 오라클 DB: Oracle Database 10g Express Edition (이하 오라클 10g XE)

이클립스가 Java EE 개발자 버전임에 유의하라. 여기서는 데이터베이스 연결을 설정하기 위해 Data Source Explorer 뷰를 사용하는데, 이는 Data Tools Platform (DTP)에 포함되어 있으며, DTP는 이클립스 Java EE 개발자 버전에서 자동으로 설치된다. 즉, 지금부터 기술할 방법으로 데이터베이스 연결을 설정하기 위해서는 최소한 DTP가 설치되어 있어야 한다. 또한, 인터페이스 언어는 영어를 기준으로 한다. 오라클 10g XE는 본 블로그의 이전 포스트(우분투 8.04 HH에 오라클 10g XE 설치)를 따라 설치하였다고 가정한다.

먼저, 이클립스 메인 메뉴에서 Windows -> Show View -> Data Source Explorer를 선택하여 Data Source Explorer 뷰를 연다. 기본적으로 화면 하단에 뷰가 열릴 것이다. 뷰에 있는 Database Connections 항목을 우클릭하여 나오는 팝업 메뉴에서 'New...'를 선택하면, 그림 1과 같이 New Connection Profile 대화창이 열린다. 여러가지 데이터베이스 중에서 'Oracle'을 선택하고, 'Name'에는 원하는 이름을 넣는데, 여기서는 'Oracle 10g XE'라고 하였다. 완료되면 'Next' 버튼을 눌러 다음으로 진행한다.


다음에는 JDBC 드라이버와 연결 상세를 설정하여야 하는데, 'Drivers' 항목의 오른쪽에 있는 추가 버튼('+' 모양)을 눌러 New Driver Definition 대화창을 띄운다. 대화창이 뜨면, 먼저 'Name/Type' 탭에서 그림 2와 같이 System Version이 '10'인 'Oracle Thin Driver'를 선택한다.


드라이버를 선택하면, 위 그림에서처럼 JAR/zip의 위치를 못찾겠다는 에러 메시지가 뜨게 되는데, 이는 다음 탭인 'Jar List' 탭에서 설정해 주면 된다. 'Jar List' 탭의 'Clear All' 버튼을 눌러 디폴트로 추가된 설정을 삭제한 뒤, 'Add JAR/Zip' 버튼을 눌러 설치된 오라클 10g XE의 위치에서 'ojdbc14.jar' 파일을 찾아서 추가한다. 'ojdbc14.jar' 파일은 기본적으로 다음과 같은 위치에 있다.


추가를 완료하면 다음의 그림 3과 같이 될 것이다.


'Properties' 탭에서는 다른 디폴트 값은 그대로 두고, 'Connection URL' 항목에서 SID 부분, 즉 ':db'를 삭제하고, 'Database Name'은 'xe'로 한다. 'Password'와 'User ID'는 오라클 데이터베이스에서 미리 생성한 계정 정보를 입력한다. 설정이 완료되면 다음 그림과 같을 것이다.


'OK' 버튼을 누르면 설정한 내용이 반영되어 New Connection Profile 대화창에 나타난다. 'SID'와 'Port number' 항목이 비어 있는 것을 볼 수 있는데, 각각 'xe'와 '1521'을 입력한다. 포트 번호는 시스템에 따라 다를 수 있으며, 1521은 오라클 데이터베이스의 디폴트 포트 번호이다. 설정을 완료하면 다음 그림 5와 같이 된다.


아래 'Test Connection' 버튼을 눌러 연결 테스트를 수행하여 제대로 되는지 확인한 후, 이상이 없으면 'Next' 버튼을 눌러 최종적으로 설정 내역을 확인한 후, 'Finish' 버튼을 눌러 연결 설정을 완료한다.

연결 설정이 완료되면, Database Connections 항목 아래에 오라클 데이터베이스 연결 항목이 생성되는 것을 볼 수 있다. 트리를 확장하면, 하위에 'xe' 노드가 있고, 그 하위에 'Roles', 'Schemas', 'Users' 항목이 나타나는데, 'Schemas' 노드를 확장하면 모든 스키마들이 다 표시되는 것을 볼 수 있다. 필터를 이용하면, 불필요한 정보는 보지 않도록 설정할 수 있다. 'Schemas' 항목을 우클릭한 후, 'Properties'를 눌러 속성창을 띄운다. 속성창에서 아래에 'Disable filter'의 체크 박스를 체크 해제하면, 그 위의 두 라디오 박스가 활성화 되는데, 그 중 'Selection'을 선택한 후, 아래 리스트 중에 아까 입력한 오라클 데이터베이스의 계정명으로 된 항목만을 선택하고 'OK' 버튼을 누르면 그 스키마만 보이는 것을 확인할 수 있을 것이다.

* 참고 문헌
-Getting Started With the Oracle Database Plugin for Eclipse DTP

우분투 8.04 HH에 오라클 10g XE(Express Edition)을 설치하는 방법이다. 주의할 점은 스왑 파티션이 최소한 1GB 이상은 되어야 한다는 것이다. 최근에는 램 용량 증가에 따라 스왑 파티션을 아에 잡지 않는 경우가 있는데, 스왑 파티션이 없거나 1GB 이하일 때는 오라클 10g XE가 설치되지 않으니 반드시 스왑을 잡아야 한다. 1024MB로 딱 1GB가 되게 잡았을 때도 설치가 안되는 경우가 있다고 하니 되도록 1.5GB 이상으로 넉넉하게 하는 것이 좋을 것으로 생각된다. 스왑을 늘리거나 설정하는 방법은 다른 문서를 참조하기 바란다.

오라클은 데비안 계열 리눅스 배포판을 위해 서드 파티 저장소를 제공한다. 이 저장소를 /etc/apt/source.list 파일에 추가하거나 /etc/apt/sources.list.d/ 디렉토리 내에 파일을 만들어서 추가하면 된다. 추가할 라인은 다음과 같다.


서드 파티 저장소를 추가하였으니, 이제 해당 저장소의 GPG 인증키를 받아 인증해야 한다. 터미널에서 다음과 같이 입력하는데, root 권한으로 실행하기 위해 sudo 명령어를 사용하여야 한다.

$ sudo wget http://oss.oracle.com/el4/RPM-GPG-KEY-oracle  -O- | sudo apt-key add -

(제일 뒤에 마이너스 기호(-)를 빠뜨리면 안된다. '-' 기호는 파이프라인에서 넘어온 것을 인자로 전달하는 역할을 한다.)

'OK'가 떨어지면 제대로 된 것이다. 이제 패키지 정보를 업데이트하고 오라클 10g XE를 설치 하면 되는데, 다국어 지원을 위해 'oracle-xe' 가 아닌 'oracle-xe-universal' 패키지를 설치하도록 한다.


여기서는 aptitude를 사용하였으나 apt-get 또는 시냅틱 꾸러미 관리자를 사용해도 무방하다. 설치가 완료된 후에는 다음과 같은 명령어를 통해 환경 설정을 하도록 한다.


아래는 설정 과정이다. 포트는 디폴트로 8080을 사용하지만 톰캣 등 다른 서버가 8080 포트를 사용한다면 다른 포트를 입력해야 한다. 여기서는 8087로 하기로 한다. 직접 입력한 것은 볼드체로 표시하였으며, '[ENTER]'는 디폴트 값을 사용하기 위해 엔터를 친 것이다. 중간에 관리자(sys 및 system 계정) 암호를 묻는데, 나의 경우 특수 문자 조합은 문제를 일으켰다. 그래서 알파벳과 숫자로만 암호를 설정하는 것을 권한다.


설정이 완료되었으면 관련 환경 변수를 설정하여야 하는데, 전역 설정에 추가하려면 /etc/profile 파일을 root 권한으로 편집하고, 개인 설정에 추가하려면 홈 디렉토리의 .bashrc 파일을 수정하면 된다. 다음의 라인을 추가한다.


source 명령어를 이용하면 환경 변수가 그 쉘에 바로 적용되게 할 수 있을 것이다.

모든 게 완료되고 나면 다음과 같은 주소로 접속하여 확인하도록 한다.

http://127.0.0.1:8087/apex

* 참고 문헌
- http://www.oracle.com/technology/tech/linux/install/xe-on-kubuntu.html
- http://nameslayer.tistory.com/286
- http://ids.snu.ac.kr/wiki/Oracle_Express_Edition