파이썬 - oracledb 패키지 연동 시 Thin / Thick 모드
Oracle 데이터베이스와의 연동을 위해 oracledb 모듈을 사용할 수 있는데요,
oracledb
; https://pypi.org/project/oracledb/
$ python3 -m pip install oracledb
설명을 보면 예전에 나온
cx_Oracle의 후속 제품이라고 합니다. 그렇다고 기존 소스코드를 그대로 사용할 수는 없고 약간 수정이 필요한데요, 가령 db 연결 시 connect 함수도 cx_Oracle에서는 순서대로 (user, password, dsn)으로 넘겼던 것이 바뀌어서,
Oracledb.connect
; https://python-oracledb.readthedocs.io/en/latest/api_manual/module.html#oracledb.connect
oracledb.connect(dsn=None, pool=None, pool_alias=None, conn_class=None, params=None, user=None, proxy_user=None, password=None, newpassword=None, wallet_password=None, access_token=None, host=None, port=1521, protocol='tcp', https_proxy=None, https_proxy_port=0, service_name=None, sid=None, server_type=None, cclass=None, purity=oracledb.PURITY_DEFAULT, expire_time=0, retry_count=0, retry_delay=1, tcp_connect_timeout=20.0, ssl_server_dn_match=True, ssl_server_cert_dn=None, wallet_location=None, events=False, externalauth=False, mode=oracledb.AUTH_MODE_DEFAULT, disable_oob=False, stmtcachesize=oracledb.defaults.stmtcachesize, edition=None, tag=None, matchanytag=False, config_dir=oracledb.defaults.config_dir, appcontext=[], shardingkey=[], supershardingkey=[], debug_jdwp=None, connection_id_prefix=None, ssl_context=None, sdu=8192, pool_boundary=None, use_tcp_fast_open=False, ssl_version=None, program=oracledb.defaults.program, machine=oracledb.defaults.machine, terminal=oracledb.defaults.terminal, osuser=oracledb.defaults.osuser, driver_name=oracledb.defaults.driver_name, handle=0)
이제는 keyword parameter 방식으로 전달해야 합니다.
import cx_Oracle
# cx_Oracle에서는 동작한 코드
# con = cx_Oracle.connect('hr', 'hr2', '192.168.100.50:1521/XE')
import oracledb
# oracledb에서는 이렇게 변경 (Use keyword parameters)
con = oracledb.connect(user='hr', password='hr2', dsn='192.168.100.50:1521/XE')
또한, 기존의 cx_Oracle과는 달리 "Oracle Client 라이브러리" 의존성에 따라 "Thin" / "Thick" 모드로 나뉘게 되는데,
26. Appendix A: Oracle Database Features Supported by python-oracledb
; https://python-oracledb.readthedocs.io/en/latest/user_guide/appendix_a.html#featuresummary
별다른 의존성 없이 oracledb만으로 코드를 수행할 수 있는 Thin 모드는 반드시 Oracle 서버가 12.1 이상이어야 합니다. 만약 그 미만의 Oracle 서버에 대해 Thin 모드로 접속한다면 connect 수행 시 이런 오류가 발생합니다.
oracledb.exceptions.OperationalError: DPY-6005: cannot connect to database (CONNECTION_ID=6LOPu6H8eKXV5MLoQRYlpw==).
DPY-3010: connections to this database server version are not supported by python-oracledb in thin mode
Help: https://python-oracledb.readthedocs.io/en/latest/user_guide/troubleshooting.html#dpy-3010
다행히 oracledb 모듈을 걷어낼 필요는 없고 Oracle Client 라이브러리를 설치한 후 소스코드에 다음과 같은 호출을 추가해 Thick 모드로 구동시키면 12.1 미만의 오라클 서버에도 접속할 수 있습니다.
# Enabling python-oracledb Thick mode
# https://python-oracledb.readthedocs.io/en/latest/user_guide/initialization.html#enablingthick
# 만약 기존 cx_Oracle 코드를 마이그레이션하는 경우라면 이미 현재 환경에 Oracle Client 라이브러리가 설치돼 있을 것이므로
# oracledb.init_oracle_client() 호출만 추가하면 됩니다.
oracledb.init_oracle_client() # thick 모드로 동작 (윈도우나 MacOS에서는 Oracle Client 라이브러리가 있는 디렉터리 경로를 전달)
con = oracledb.connect(user='hr', password='hr2', dsn='192.168.100.50:1521/XE')
[이 글에 대해서 여러분들과 의견을 공유하고 싶습니다. 틀리거나 미흡한 부분 또는 의문 사항이 있으시면 언제든 댓글 남겨주십시오.]