Microsoft MVP성태의 닷넷 이야기
스크립트: 70. 파이썬 - oracledb 패키지 연동 시 Thin / Thick 모드 [링크 복사], [링크+제목 복사],
조회: 3995
글쓴 사람
정성태 (seongtaejeong at gmail.com)
홈페이지
첨부 파일
 

(시리즈 글이 3개 있습니다.)
스크립트: 39. Python에서 cx_Oracle 환경 구성
; https://www.sysnet.pe.kr/2/0/13071

스크립트: 70. 파이썬 - oracledb 패키지 연동 시 Thin / Thick 모드
; https://www.sysnet.pe.kr/2/0/13882

스크립트: 72. 파이썬 - SQLAlchemy + oracledb 연동
; https://www.sysnet.pe.kr/2/0/13900




파이썬 - 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')




[이 글에 대해서 여러분들과 의견을 공유하고 싶습니다. 틀리거나 미흡한 부분 또는 의문 사항이 있으시면 언제든 댓글 남겨주십시오.]







[최초 등록일: ]
[최종 수정일: 3/5/2025]

Creative Commons License
이 저작물은 크리에이티브 커먼즈 코리아 저작자표시-비영리-변경금지 2.0 대한민국 라이센스에 따라 이용하실 수 있습니다.
by SeongTae Jeong, mailto:techsharer at outlook.com

비밀번호

댓글 작성자
 




... 76  77  78  79  80  81  82  83  84  [85]  86  87  88  89  90  ...
NoWriterDateCnt.TitleFile(s)
11848정성태3/17/201920285스크립트: 14. 윈도우 CMD - 파일이 변경된 경우 파일명을 변경해 복사하고 싶다면?
11847정성태3/17/201924688Linux: 7. 리눅스 C/C++ - 공유 라이브러리 동적 로딩 후 export 함수 사용 방법파일 다운로드1
11846정성태3/15/201923407Linux: 6. getenv, setenv가 언어/운영체제마다 호환이 안 되는 문제
11845정성태3/15/201923010Linux: 5. Linux 응용 프로그램의 (C++) so 의존성 줄이기(ReleaseMinDependency) [3]
11844정성태3/14/201924889개발 환경 구성: 434. Visual Studio 2019 - 리눅스 프로젝트를 이용한 공유/실행(so/out) 프로그램 개발 환경 설정 [1]파일 다운로드1
11843정성태3/14/201919645기타: 75. MSDN 웹 사이트를 기본으로 영문 페이지로 열고 싶다면?
11842정성태3/13/201917362개발 환경 구성: 433. 마이크로소프트의 CoreCLR 프로파일러 예제를 Visual Studio CMake로 빌드하는 방법 [1]파일 다운로드1
11841정성태3/13/201917927VS.NET IDE: 132. Visual Studio 2019 - CMake의 컴파일러를 기본 g++에서 clang++로 변경
11840정성태3/13/201920033오류 유형: 526. 윈도우 10 Ubuntu App 환경에서는 USB 외장 하드 접근 불가
11839정성태3/12/201924197디버깅 기술: 124. .NET Core 웹 앱을 호스팅하는 Azure App Services의 프로세스 메모리 덤프 및 windbg 분석 개요 [3]
11838정성태3/7/201927951.NET Framework: 811. (번역글) .NET Internals Cookbook Part 1 - Exceptions, filters and corrupted processes [1]파일 다운로드1
11837정성태3/6/201941564기타: 74. 도서: 시작하세요! C# 7.3 프로그래밍 [10]
11836정성태3/5/201925296오류 유형: 525. Visual Studio 2019 Preview 4/RC - C# 8.0 Missing compiler required member 'System.Range..ctor' [1]
11835정성태3/5/201923239.NET Framework: 810. C# 8.0의 Index/Range 연산자를 .NET Framework에서 사용하는 방법 및 비동기 스트림의 컴파일 방법 [3]파일 다운로드1
11834정성태3/4/201921938개발 환경 구성: 432. Visual Studio 없이 최신 C# (8.0) 컴파일러를 사용하는 방법
11833정성태3/4/201923084개발 환경 구성: 431. Visual Studio 2019 - CMake를 이용한 공유/실행(so/out) 리눅스 프로젝트 설정파일 다운로드1
11832정성태3/4/201917937오류 유형: 524. Visual Studio CMake - rsync: connection unexpectedly closed
11831정성태3/4/201918686오류 유형: 523. Visual Studio 2019 - 새 창으로 뜬 윈도우를 닫을 때 비정상 종료
11830정성태2/26/201917918오류 유형: 522. 이벤트 로그 - Error opening event log file State. Log will not be processed. Return code from OpenEventLog is 87.
11829정성태2/26/201919223개발 환경 구성: 430. 마이크로소프트의 CoreCLR 프로파일러 예제 빌드 방법 - 리눅스 환경 [1]
11828정성태2/26/201927859개발 환경 구성: 429. Component Services 관리자의 RuntimeBroker 설정이 2개 있는 경우 [8]
11827정성태2/26/201920159오류 유형: 521. Visual Studio - Could not start the 'rsync' command on the remote host, please install it using your system package manager.
11826정성태2/26/201920711오류 유형: 520. 우분투에 .NET Core SDK 설치 시 패키지 의존성 오류
11825정성태2/25/201926359개발 환경 구성: 428. Visual Studio 2019 - CMake를 이용한 리눅스 빌드 환경 설정 [1]
11824정성태2/25/201920601오류 유형: 519. The SNMP Service encountered an error while accessing the registry key SYSTEM\CurrentControlSet\Services\SNMP\Parameters\TrapConfiguration. [1]
11823정성태2/21/201921705오류 유형: 518. IIS 관리 콘솔이 뜨지 않는 문제
... 76  77  78  79  80  81  82  83  84  [85]  86  87  88  89  90  ...