Microsoft MVP성태의 닷넷 이야기
스크립트: 39. Python에서 cx_Oracle 환경 구성 [링크 복사], [링크+제목 복사],
조회: 8329
글쓴 사람
정성태 (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

비밀번호

댓글 작성자
 




1  2  3  4  5  6  7  8  [9]  10  11  12  13  14  15  ...
NoWriterDateCnt.TitleFile(s)
13452정성태11/22/20233268닷넷: 2166. C# - Azure OpenAI API를 이용해 사용자가 제공하는 정보를 대상으로 검색하는 방법파일 다운로드1
13451정성태11/21/20233441닷넷: 2165. C# - Azure OpenAI API를 이용해 ChatGPT처럼 동작하는 콘솔 응용 프로그램 제작파일 다운로드1
13450정성태11/21/20233232닷넷: 2164. C# - Octokit을 이용한 GitHub Issue 검색파일 다운로드1
13449정성태11/21/20233392개발 환경 구성: 688. Azure OpenAI 서비스 신청 방법
13448정성태11/20/20233649닷넷: 2163. .NET 8 - Dynamic PGO를 결합한 성능 향상파일 다운로드1
13447정성태11/16/20233568닷넷: 2162. ASP.NET Core 웹 사이트의 SSL 설정을 코드로 하는 방법
13446정성태11/16/20233472닷넷: 2161. .NET Conf 2023 - Day 1 Blazor 개요 정리
13445정성태11/15/20233859Linux: 62. 리눅스/WSL에서 CA 인증서를 저장하는 방법
13444정성태11/15/20233564닷넷: 2160. C# 12 - Experimental 특성 지원
13443정성태11/14/20233505개발 환경 구성: 687. OpenSSL로 생성한 사용자 인증서를 ASP.NET Core 웹 사이트에 적용하는 방법
13442정성태11/13/20233280개발 환경 구성: 686. 비주얼 스튜디오로 실행한 ASP.NET Core 사이트를 WSL 2 인스턴스에서 https로 접속하는 방법
13441정성태11/12/20233742닷넷: 2159. C# - ASP.NET Core 프로젝트에서 서버 Socket을 직접 생성하는 방법파일 다운로드1
13440정성태11/11/20233298Windows: 253. 소켓 Listen 시 방화벽의 Public/Private 제어 기능이 비활성화된 경우
13439정성태11/10/20234118닷넷: 2158. C# - 소켓 포트를 미리 시스템에 등록/예약해 사용하는 방법(Port Exclusion Ranges)파일 다운로드1
13438정성태11/9/20233475닷넷: 2157. C# - WinRT 기능을 이용해 윈도우에서 실행 중인 Media App 제어
13437정성태11/8/20233620닷넷: 2156. .NET 7 이상의 콘솔 프로그램을 (dockerfile 없이) 로컬 docker에 배포하는 방법
13436정성태11/7/20233863닷넷: 2155. C# - .NET 8 런타임부터 (Reflection 없이) 특성을 이용해 public이 아닌 멤버 호출 가능
13435정성태11/6/20233753닷넷: 2154. C# - 네이티브 자원을 포함한 관리 개체(예: 스레드)의 GC 정리
13434정성태11/1/20233488스크립트: 62. 파이썬 - class의 정적 함수를 동적으로 교체
13433정성태11/1/20233054스크립트: 61. 파이썬 - 함수 오버로딩 미지원
13432정성태10/31/20233389오류 유형: 878. 탐색기의 WSL 디렉터리 접근 시 "Attempt to access invalid address." 오류 발생
13431정성태10/31/20233782스크립트: 60. 파이썬 - 비동기 FastAPI 앱을 gunicorn으로 호스팅
13430정성태10/30/20233600닷넷: 2153. C# - 사용자가 빌드한 ICU dll 파일을 사용하는 방법
13429정성태10/27/20233778닷넷: 2152. Win32 Interop - C/C++ DLL로부터 이중 포인터 버퍼를 C#으로 받는 예제파일 다운로드1
13428정성태10/25/20233865닷넷: 2151. C# 12 - ref readonly 매개변수
13427정성태10/18/20234099닷넷: 2150. C# 12 - 정적 문맥에서 인스턴스 멤버에 대한 nameof 접근 허용(Allow nameof to always access instance members from static context)
1  2  3  4  5  6  7  8  [9]  10  11  12  13  14  15  ...