Oracle 데이터베이스와 어플리케이션 연동 - 윈디하나의 솔라나라

분류: 오라클
설명: PHP와 Java에서 Oracle 데이터베이스를 사용하는 방법에 대해 설명 (2011-09-04)
위치: 윈디하나의 솔라나라: Oracle 데이터베이스와 어플리케이션 연동 (처음 오신 분은 윈디하나의 솔라나라 이야기를 읽어주십시오)
윈디하나의 솔라나라 트위터 @solanara

개요

Oracle Database 와 어플리케이션과의 연동및 어플리케이션에서의 사용방법에 대해 설명한다.
Java, PHP와의 연동에 대해 주로 설명했다.

준비

오라클 데이터베이스
당연한 말이지만, 아래의 예제를 따라하려면 오라클이 먼저 설치되어있어야 한다. 오라클 10g 에서도 가능하지만, 몇몇 최신 기능들은 오라클 11g만들 지원하기 때문에 가급적 최신 버전을 사용하기 바란다. 오라클의 설치는 윈디하나의 솔라나라: Oracle 10g R2, 윈디하나의 솔라나라: Oracle 11g R2, Grid Infrastructure을 읽어보자.

오라클 인스턴트 클라이언트 설치

Oracle Instant Client는 오라클 10g에서 새롭게 선 보이는 클라이언트다. 설치과정 없이 다운로드 받아 압축을 풀기만 하면 오라클 OCI 라이브러리와 SDK, SQL*Plus, JDBC드라이버를 제공해준다.
Instant Client Downloads에서 다운로드 받을 수 있다.

아래와 같이 설치할 수 있다.

root@wl ~ # unzip basic-11.2.0.2.0-solaris-x64.zip
root@wl ~ # unzip jdbc-11.2.0.2.0-solaris-x64.zip
root@wl ~ # unzip sdk-11.2.0.2.0-solaris-x64.zip
root@wl ~ # unzip sqlplus-11.2.0.2.0-solaris-x64.zip
root@wl ~ # mv instantclient_11_2 /usr/local/instantclient
root@wl ~ # vi /usr/local/instantclient/tnsnames.ora
TNS_ORCL =
  (DESCRIPTION =
    (ADDRESS = (PROTOCOL = TCP)(HOST = 192.168.0.100)(PORT = 1521))
    (CONNECT_DATA =
      (SERVER = DEDICATED)
      (SERVICE_NAME = orcl)
    )
  )
root@wl ~ # vi /etc/profile
# for Oracle Instant Client
if [ -d /usr/local/instantclient ]
then
  LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/usr/local/instantclient; export LD_LIBRARY_PATH
  PATH=$PATH:/usr/local/instantclient; export PATH;
  NLS_LANG=Korean_Korea.AL32UTF8; export NLS_LANG
  TNS_ADMIN=/usr/local/instantclient; export TNS_ADMIN;
  SQLPATH=/usr/local/instantclient; export SQLPATH;
fi
root@wl ~ # sqlplus 사용자아이디/사용자패스워드@//호스트주소:포트/DB이름
root@wl ~ # sqlplus 사용자아이디/사용자패스워드@TNS_ORCL

* 오라클 인스턴트 클라이언트는 라이브러리 파일 크기가 크기 때문에, 가상 메모리를 많이 소모한다.

DRCP

개요
오라클 11g부터 지원하는 DRCP(Database Resident Connection Pooling)를 사용하면 데이터베이스에서 커넥션 풀링을 지원한다. 또한 이를 사용해 커넥션에 소요되는 메모리를 많이 줄일 수 있다. Dedicated Server와 Shared Server보다 더 빠르다. DRCP는 PHP뿐만 아니라 다른 언어에서도 사용 가능하다. 11g R1을 사용하는 경우, Oracle bug 6474441를 패치하거나, 이 문제가 해결된 Oracle Database 11.1.0.7 이상 버전을 사용하자.
Database Resident Connection Pooling (DRCP) Oracle Database 11g Technical White paper

설정

데이터베이스에서 DRCP 설정 및 시작. 현재는 한개의 풀(시스템 기본 풀)만 지원된다.

SQL> connect / as sysdba
SQL> execute dbms_connection_pool.configure_pool(null, minsize=>10, maxsize=>100, inactivity_timeout=>300, max_think_time=>600);
SQL> execute dbms_connection_pool.start_pool;
SQL> select * from DBA_CPOOL_INFO;

데이터베이스에서 DRCP 종료

SQL> execute dbms_connection_pool.stop_pool;

tnsnames.ora 파일 수정(필요하다면)

TNS_ORCL =
  (DESCRIPTION =
    (ADDRESS = (PROTOCOL = TCP)(HOST = 192.168.0.100)(PORT = 1521))
    (CONNECT_DATA =
      (SERVER = POOLED)
      (SERVICE_NAME = orcl)
    )
  )

접속방법

root@wl ~ # sqlplus 사용자아이디/사용자패스워드@//호스트주소:포트/DB이름:POOLED
root@wl ~ # sqlplus 사용자아이디/사용자패스워드@TNS_ORCL

DRCP 상태 보기

아래의 4개 딕셔너리를 사용한다.

SQL> select * from DBA_CPOOL_INFO;
SQL> select * from V$CPOOL_STATS;
SQL> select * from V$CPOOL_CC_INFO;
SQL> select * from V$CPOOL_CC_STATS;

오라클 관련 어플리케이션 설정

환경변수
모든 오라클 관련 어플리케이션은 ORACLE_HOME 환경변수가 있어야 동작한다. 따라서 톰캣이나 아파치/PHP을 사용할 때에도 웹서버를 띄우기 전에 ORACLE_HOME 환경변수가 존재하는지 확인해야 한다.
한글문제
- 한글문제 해결의 기본은 '클라이언트 소프트웨어'에서 NLS_LANG 환경 변수를 지정하는 것이다.
- [export NLS_LANG=Korean_Korea.KO16KSC5601]로 설정하는 것이 가장 고전적인 방법으로 [완성형] 한글코드를 사용하는 클라이언트에서 사용할 수 있다. 이경우 메시지가 한글로 나오는데, 이는 [Korean_Korea] 대신 [American_America] 을 사용해 해결할 수 있다.
- [export NLS_LANG=Korean_Korea.KO16MSWIN949]도 사용 가능하다. 이는 [확장완성형] 한글코드를 사용하는 클라이언트에서 사용할 수 있다. 윈도 기반의 클라이언트는 대부분 지원된다. '똠' 이나 '샾' 등의 글자가 지원된다.
- [export NLS_LANG=Korean_Korea.AL32UTF8]는 유니코드 기반의 UTF-8 인코딩을 사용하는 클라이언트에서 사용할 수 있다. 솔라나라에서는 솔라리스를 UTF-8로 설치했기 때문에 이렇게 사용한다.

Java

JDBC, Thin Driver
자바용 오라클 JDBC드라이버는 크게 두가지가 있다. 하나는 Java JDBC THIN 드라이버고, 다른 하나는 OCI기반의 드라이버이다. THIN드라이버의 경우 오라클 클라이언트 라이브러리를 설치할 필요 없다는 장점이있다. (현재 오라클은 OCI기반의 JDBC드라이버를 제공하지 않는다) 따라서 이 문서는 THIN드라이버를 기준으로 한다. 오라클을 설치하면 $ORACLE_HOME/jdbc/lib 에 Java용 JDBC 드라이버가 설치되며, 단순히 CLASS_PATH 에 $ORACLE_HOME/jdbc/lib 를 넣어주면 JDBC 드라이버를 사용할 수 있다. 오라클을 설치하지 않아도 JDBC 드라이버만 JDBC/UCP Download Page에서 무료로 받을 수 있다. CLASS_PATH를 수정할 수 없는 경우 아래와 같은 방법을 사용할 수 있다.
Java 1.5 이상
Oracle 11g의 최신 JDBC드라이버를 사용할 수 있다. ojdbc5.jar(자바 1.5) 또는 ojdbc6.jar(자바 1.6) 드라이버를 CLASS_PATH에 지정된 디렉토리에 넣어준다. orai18n.jar 을 같이 넣어주면 오류메시지등이 한글로 나온다.
Java 1.4
오라클 10g의 최신 JDBC드라이버를 사용할 수 있다. ojdbc14.jar 와 orai18n.jar 를 CLASS_PATH에 지정된 디렉토리에 넣는다.
Java 1.2, 1.3
오라클 10g의 최신 JDBC드라이버를 사용할 수 있다. classes12.jar nls_charset12.jar 를 CLASS_PATH에 지정된 디렉토리에 넣는다.
UCP
오라클은 JDBC 드라이버에서 제공하던 커넥션 풀(커넥션 캐시)를 더이상 지원하지 않고, 대신 UCP(Universal Connection Pool)를 통해 지원한다. UCP를 사용하려면 다운로드 페이지에서 ucp.jar 를 받아 JDBC 드라이버가 위치한 디렉토리에 복사한다.

PHP

오라클 OCI
윈디하나의 솔라나라: AMP에서 PHP컴파일시 ./configure부분을 다음을 추가한다. ./configure 를 실행하기 전에 오라클 환경 변수 ORACLE_HOME이 설정되어있어야 하며 오라클 서버 또는 오라클 클라이언트를 설치해야 한다.
```
root@wl ~/php-5.3.3 # . ~oracle/.profile
root@wl ~/php-5.3.3 # ./configure \
...
  --with-oci8 \
  --enable-sigchild
```
인스턴트 클라이언트
PHP 4.3.11, PHP 5.0.4이후 오라클 인스턴트 클라이언트(Oracle Instant Client)를 공식 지원한다. 아래는 PHP 5.3에서의 인스턴트 클라이언트를 이용한 방법이다. 이전 버전에서는 설정 방법이 약간 다르므로 매뉴얼을 참고하기 바란다.
```
root@wl ~/php-5.3.3 # ./configure \
...
  --with-oci8=instantclient,/usr/local/instantclient \
  --enable-sigchild
```
PHP에서 DRCP 사용하기
PHP에서 DRCP를 사용하기 위해서는 [PHP-OCI8 EXTENSIONS v1.3]이 필요하다. 이는 PHP 5.3 부터 번들되어있다. 오라클 서버에서 DRCP설정을 한 후, PHP 소스에서 아래와 같이 oci_pconnect 를 사용한다.
```
$conn = oci_pconnect("아이디", "패스워드", "TNS_ORCL"); // TNS설정에 'SERVER = POOLED'이 있어야 함
$conn = oci_pconnect("아이디", "패스워드", "호스트주소:포트/서비스이름:POOLED");
```
php.ini에 다음을 추가해야 한다.
```
root@wl /usr/local/php/lib # vi php.ini
oci8.connection_class = "SOLANARA_APP"
```

PHP에서 FAN 사용하기

FAN이란, Fast Application Notification을 의미한다. 역시 PHP 5.3부터 지원된다.

SQL> execute dbms_service.modify_service(SERVICE_NAME => 'orcl', AQ_HA_NOTIFICATIONS => TRUE);

php.ini에 다음을 추가한다.

root@wl /usr/local/php/lib # vi php.ini
oci8.events = On

RSS ATOM XHTML 5 CSS3

Oracle 데이터베이스와 어플리케이션 연동 - 윈디하나의 솔라나라

목차

개요

준비

오라클 데이터베이스

오라클 인스턴트 클라이언트 설치

DRCP

개요

설정

DRCP 상태 보기

오라클 관련 어플리케이션 설정

환경변수

한글문제

Java

JDBC, Thin Driver

Java 1.5 이상

Java 1.4

Java 1.2, 1.3

UCP

PHP

오라클 OCI

인스턴트 클라이언트

PHP에서 DRCP 사용하기

PHP에서 FAN 사용하기