Microsoft MVP성태의 닷넷 이야기
스크립트: 39. Python에서 cx_Oracle 환경 구성 [링크 복사], [링크+제목 복사]
조회: 6446
글쓴 사람
정성태 (techsharer at outlook.com)
홈페이지
첨부 파일
 

Python에서 cx_Oracle 환경 구성

파이썬에서 Oracle 연결은 파이썬 패키지뿐만 아니라,

$ pip install cx_Oracle

네이티브 모듈도 함께 설치를 해야 합니다.

// cx_Oracle 8 Installation
// ; https://cx-oracle.readthedocs.io/en/latest/user_guide/installation.html

$ sudo mkdir -p /opt/oracle
$ cd /opt/oracle
$ sudo wget https://download.oracle.com/otn_software/linux/instantclient/216000/instantclient-basic-linux.x64-21.6.0.0.0dbru.zip
$ sudo unzip instantclient-basic-linux.x64-21.6.0.0.0dbru.zip

$ sudo apt install libaio1
$ sudo sh -c "echo /opt/oracle/instantclient_21_6 > /etc/ld.so.conf.d/oracle-instantclient.conf"
$ sudo ldconfig

위와 같이만 구성해 주면 이제 cx_Oracle.connect에 적절한 연결 정보를 전달해 실행할 수 있습니다. 예를 들어, 닷넷의 경우 이렇게 연결 문자열을 구성했다면,

Data Source=(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=192.168.100.50)(PORT=1521))(CONNECT_DATA=(SERVICE_NAME=XE)));User Id=hr;Password=hrpass;

파이썬에서도 유사하게 이런 식으로 전달하면 됩니다.

dsn = """(DESCRIPTION=
                (ADDRESS=(PROTOCOL=tcp)(HOST=192.168.0.8)(PORT=1521))
                (CONNECT_DATA=(SERVICE_NAME=XE)))"""

con = cx_Oracle.connect(user='hr', password='hrpass', dsn=dsn)

혹은 좀 더 약식으로 id, password 및 "HOST:PORT/SERVICE_NAME" 형식으로 다음과 같이 연결 테스트를 할 수 있습니다.

import cx_Oracle
oc = cx_Oracle.connect('hr', 'hrpass', '192.168.100.50:1521/XE')




참고로, dockerfile로 구성한다면 instantclient-basic-linux.x64-21.6.0.0.0dbru.zip 파일을 dockerfile 위치에 미리 복사해 둔 후 (혹은 그것조차도 dockerfile에서 wget으로 받아두거나) 이런 식으로 구성하면 됩니다.

FROM python:3.8-slim-buster
...[생략]...
RUN mkdir -p /opt/oracle
RUN cd /opt/oracle
COPY instantclient-basic-linux.x64-21.6.0.0.0dbru.zip /opt/oracle/ora_native.zip
RUN unzip ora_native.zip
RUN apt install libaio1
RUN sh -c "echo /opt/oracle/instantclient_21_6 > /etc/ld.so.conf.d/oracle-instantclient.conf"
RUN ldconfig
...[생략]...

이후의 python 내에서 사용하는 방법은 일반적인 dbapi2 인터페이스를 따릅니다.




혹시나 다음과 같은 오류가 발생한다면?

DatabaseError at /bbs/oracletest
DPI-1047: Cannot locate a 64-bit Oracle Client library: "libclntsh.so: cannot open shared object file: No such file or directory". See https://cx-oracle.readthedocs.io/en/latest/user_guide/installation.html for help

네이티브 모듈(instantclient-basic-linux.x64-21.6.0.0.0dbru.zip)을 설치하지 않아서 그런 것입니다.


참고로, 네이티브 모듈 없이 cx_Oracle 패키지만 내려받아 사용하면 cx_Oracle.connect는 (오류 없이) None을 반환합니다. 그런 탓에 None 체크 없이 곧바로 cursor를 사용하려는 경우,

import cx_Oracle
con = cx_Oracle.connect('...', '...', '...')
cursor = con.cursor()

이런 오류가 발생할 수 있습니다.

Traceback (most recent call last):
  File "/home/testusr/.local/lib/python3.8/site-packages/uvicorn/protocols/http/httptools_impl.py", line 435, in run_asgi
    result = await app(  # type: ignore[func-returns-value]
  ...[생략]...
  File "/mnt/c/temp/testprj/p38fastapi/main.py", line 255, in cxoracle_test
    text1 = test_cxoracle_1()
  File "/mnt/c/temp/testprj/p38fastapi/main.py", line 265, in test_cxoracle_1
    cursor = con.cursor()
AttributeError: 'NoneType' object has no attribute 'cursor'

또는 with 문과 사용한다면,

import cx_Oracle

with cx_Oracle.connect(user='...', password='...', dsn='...') as con:
    with con.cursor() as cursor:
        pass

connect 문에서 다음과 같은 예외가 발생합니다.

Traceback (most recent call last):
  File "/home/testusr/.local/lib/python3.8/site-packages/uvicorn/protocols/http/httptools_impl.py", line 435, in run_asgi
    result = await app(  # type: ignore[func-returns-value]
  ...[생략]....
  File "/mnt/c/temp/testprj/p38fastapi/main.py", line 286, in test_cxoracle_2
    with cx_Oracle.connect(user='...', password='...', dsn='...') as con:
AttributeError: __enter__





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







[최초 등록일: ]
[최종 수정일: 6/21/2023]

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

비밀번호

댓글 작성자
 




... [16]  17  18  19  20  21  22  23  24  25  26  27  28  29  30  ...
NoWriterDateCnt.TitleFile(s)
13193정성태12/14/20224422오류 유형: 832. error C7681: two-phase name lookup is not supported for C++/CLI or C++/CX; use /Zc:twoPhase-
13192정성태12/13/20224384Linux: 55. 리눅스 - bash shell에서 실수 연산
13191정성태12/11/20225302.NET Framework: 2077. C# - 직접 만들어 보는 SynchronizationContext파일 다운로드1
13190정성태12/9/20225711.NET Framework: 2076. C# - SynchronizationContext 기본 사용법파일 다운로드1
13189정성태12/9/20225944오류 유형: 831. Visual Studio - Windows Forms 디자이너의 도구 상자에 컨트롤이 보이지 않는 문제
13188정성태12/9/20225199.NET Framework: 2075. C# - 직접 만들어 보는 TaskScheduler 실습 (SingleThreadTaskScheduler)파일 다운로드1
13187정성태12/8/20225091개발 환경 구성: 654. openssl - CA로부터 인증받은 새로운 인증서를 생성하는 방법 (2)
13186정성태12/6/20223652오류 유형: 831. The framework 'Microsoft.AspNetCore.App', version '...' was not found.
13185정성태12/6/20224540개발 환경 구성: 653. Windows 환경에서의 Hello World x64 어셈블리 예제 (NASM 버전)
13184정성태12/5/20223928개발 환경 구성: 652. ml64.exe와 link.exe x64 실행 환경 구성
13183정성태12/4/20223758오류 유형: 830. MASM + CRT 함수를 사용하는 경우 발생하는 컴파일 오류 정리
13182정성태12/4/20224420Windows: 217. Windows 환경에서의 Hello World x64 어셈블리 예제 (MASM 버전)
13181정성태12/3/20223811Linux: 54. 리눅스/WSL - hello world 어셈블리 코드 x86/x64 (nasm)
13180정성태12/2/20224067.NET Framework: 2074. C# - 스택 메모리에 대한 여유 공간 확인하는 방법파일 다운로드1
13179정성태12/2/20223537Windows: 216. Windows 11 - 22H2 업데이트 이후 Terminal 대신 cmd 창이 뜨는 경우
13178정성태12/1/20223978Windows: 215. Win32 API 금지된 함수 - IsBadXxxPtr 유의 함수들이 안전하지 않은 이유파일 다운로드1
13177정성태11/30/20224759오류 유형: 829. uwsgi 설치 시 fatal error: Python.h: No such file or directory
13176정성태11/29/20223704오류 유형: 828. gunicorn - ModuleNotFoundError: No module named 'flask'
13175정성태11/29/20225009오류 유형: 827. Python - ImportError: cannot import name 'html5lib' from 'pip._vendor'
13174정성태11/28/20223911.NET Framework: 2073. C# - VMMap처럼 스택 메모리의 reserve/guard/commit 상태 출력파일 다운로드1
13173정성태11/27/20224549.NET Framework: 2072. 닷넷 응용 프로그램의 스레드 스택 크기 변경
13172정성태11/25/20224444.NET Framework: 2071. 닷넷에서 ESP/RSP 레지스터 값을 구하는 방법파일 다운로드1
13171정성태11/25/20224031Windows: 214. 윈도우 - 스레드 스택의 "red zone"
13170정성태11/24/20224384Windows: 213. 윈도우 - 싱글 스레드는 컨텍스트 스위칭이 없을까요?
13169정성태11/23/20224918Windows: 212. 윈도우의 Protected Process (Light) 보안 [1]파일 다운로드2
13168정성태11/22/20224252제니퍼 .NET: 31. 제니퍼 닷넷 적용 사례 (9) - DB 서비스에 부하가 걸렸다?!
... [16]  17  18  19  20  21  22  23  24  25  26  27  28  29  30  ...