[Spring Web Project] 스프링과 Oracle Database 연동(1) - Oracle 설치 및 설정

오라클 설치

Oracle Database는 'Express Edition(이하 XE)'이라고 하는 단일 데이터베이스 구성용 프로그램을 설치해서 사용한다. (2023년 10월 현재 21 버전만 다운로드가 가능한 상황)

 

이 책('코드로 배우는 스프링 웹프로젝트')의 예제는 11g XE를 이용하기 때문에 나 역시 11g XE를 사용할 것이다.

2021년 중반부터 11g XE는 오라클 사이트에서 다운로드가 불가능하므로 따로 책에서 준 링크를 이용해서 다운로드 받을 것이다.

 

 

혹시나 11g XE를 다운받고 싶다면 아래 링크 들어가서 다운받기

XE Prior Release Archive

※ 만약, 18c XE를 이용하고자 한다면 데이터베이스 내 사용자 계정 생성 시에 'C##'이라는 접두어만 붙이면 동일하게 이용 가능

 

먼저, 11g XE를 다운받은 뒤 압축 해제한 뒤 폴더 들어가기

 

setup.exe 클릭

 

Next 누르기

 

I accet the terms in the license agreement에 체크하고 Next 누르기

 

Next 누르기

 

SYS 계정 패스워드 지정 후 Next 누르기

 

⚠️ 설치하는 중간 과정에 System, SYS 계정의 패스워드를 지정하게 되는데, 이 패스워드는 무척 중요하기 때문에 반드시 기억해야 합니다(System 계정의 패스워드는 다른 사용자 계정을 만들 때도 필요합니다.).

 

Install 누르기

 

정상적으로 오라클 설치 완료

 

SQL Developer 설치

오라클을 이용할 때 기본적으로 제공되는 SQL Plus를 이용하는 방식도 나쁘지는 않지만, 가능하면 좀 더 많은 기능을 가지고 있는 SQL Developer를 이용하면 편리합니다. SQL Developer는 무료로 다운로드 받을 수 있고, 다운로드 후에 압축을 해제해서 사용하면 됩니다.

 

Oracle SQL Developer Downloads

 

(어떤 플랫폼을 깔아도 상관없지만 나는 JDK가 포함된 플랫픔(Windows 64-bit with JDK 11 included)을 다운받았다.)

 

다운로드한 Sql Developer는 별도의 설치 절차 없이 압축파일을 해제하고 실행하면 된다. 실행된 화면창에서 왼쪽 상단 플러스 기호를 누른다.

 

 

데이터베이스에 접속할때는 아래와 같은 화면을 이용하게 됩니다.

 

 

계정의 이름은 System으로 지정하고 비밀번호는 아까 oracle 설치했을 때 설정했던 비밀번호를 입력하면 된다. 호스트의 이름은 localhost, 포트는 1521번, SID는 xe라는 이름으로 접속해 보고 데이터베이스 연결에 아무 문제가 없는 것을 확인한 후 다음 단계를 진행합니다.  

예제에 사용하는 계정 생성

SQL Developer에 System 계정으로 접속에 성공한 후에는 예제에서 사용할 계정을 만들어 줍니다.

사용자를 생성하기 위해서는 접속 후에 보이는 텍스트 편집기를 이용합니다.

 

 

사용자 생성시 계정의 이름은 'book_ex'로 지정하고(※ 대소문자 주의 ※), IDENTIFIED BY 뒤에는 패스워드를 지정합니다. 기본 테이블 스페이스는 'USERS'로 지정하고, 임시 테이블 스페이스는 'TEMP'로 지정합니다.

편집기 화면에서 아래의 내용을 추가한 후에 '실행'메뉴로 사용자를 생성합니다.

 

 

정상적으로 사용자가 생성되면 아래와 같은 결과를 확인할 수 있습니다.

 

 

오라클의 사용자 계정으로 특정 행위를 하기 위해서는 권한이나 롤(role)이 필요하므로 GRANT구문을 이용해서 처리합니다.

 

 

GRANT로 사용자에게 접속(connect) 권한과 DBA 권한을 부여합니다.

 

 

올바르게 연결 정보가 되었는지 확인하기 위해서 다시 기존의 연결을 해제하고 새롭게 연결을 시도해서 성공하는지를 확인합니다.

 

Oracle 접속 해제 및 새 접속

 

테스트(T)를 눌렀을 때 올바르게 연결 정보가 되었다면 왼쪽 하단에 상태가 성공으로 뜬다

 

SQL Developer는 내부적으로 JDBC를 이용해서 데이터베이스와 연결을 처리하기 때문에, SQL Developer에서 연결이 불가능하다면 프로그램을 작성해도 제대로 동작하지 않을 가능성이 높습니다. 따라서 JDBC 연결을 테스트하기 전에 연결이 가능한지 테스트해 보는 것이 좋습니다.

 

8080 포트 변경

오라클 11g의 경우 기본적으로 8080 포트를 이용해서 웹 환경으로도 데이터베이스를 접근할 수 있습니다. 문제는 웹 개발 시 많이 사용하는 Tomcat의 기본 포트가 8080이기 때문에 동시에 오라클과 Tomcat이 8080 포트를 사용하는 문제를 가지게 됩니다. 이 문제를 해결하기 위해 오라클의 포트를 변경해 주는 것이 좋습니다.

 

자신의 포트번호를 모른다면 'select dbms_xdb.gethttpport() from dual;'을 이용해서 현재 사용하는 포트 번호가 몇 번인지 확인합니다.

 

만약, 쿼리의 결과가 8080으로 출력되는 경우 exec dbms_xdb.sethttpport(9090);을 이용해서 포트를 변경합니다. 보통 1000번 이하의 포트는 예약 포트이므로, 9090이나 9000 등 원하는 번호로 변경해야 합니다. 포트 변경 후에는 다시 포트를 확인해서 정상적으로 변경되었는지 확인해야 합니다.

 

 

정상적으로 포트 변경이되면 아래와 같은 결과를 확인할 수 있습니다.