J & J - 정성태의 닷넷 이야기

사용자

메뉴

최근 덧글

[정성태] 그냥 RSS Reader 기능과 약간의 UI 편의성 때문에 사용...[이종효] 오래된 소프트웨어는 보안 위협이 되기도 합니다. 혹시 어떤 기능...[정성태] @Keystroke IEEE의 문서를 소개해 주시다니... +_...[손민수 (Keystroke)] 괜히 듀얼채널 구성할 때 한번에 같은 제품 사라고 하는 것이 아...[정성태] 전각(Full-width)/반각(Half-width) 기능을 토...[정성태] Vector에 대한 내용은 없습니다. Vector가 닷넷 BCL...[orion] 글 읽고 찾아보니 디자인 타임에는 InitializeCompon...[orion] 연휴 전에 재현 프로젝트 올리자 생각해 놓고 여의치 않아서 못 ...[정성태] 아래의 글에 정리했으니 참고하세요. C# - Typed D...[정성태] 간단한 재현 프로젝트라도 있을까요? 저런 식으로 설명만 해...

글쓰기

제목

이름

암호

전자우편

HTML

홈페이지

유형

내용

<div style='display: inline'>
<h1 style='font-family: Malgun Gothic, Consolas; font-size: 20pt; color: #006699; text-align: center; font-weight: bold'>Python에서 cx_Oracle 환경 구성</h1>

파이썬에서 Oracle 연결은 파이썬 패키지뿐만 아니라, 
 
<pre style='margin: 10px 0px 10px 10px; padding: 10px 0px 10px 10px; background-color: #fbedbb; overflow: auto; font-family: Consolas, Verdana;' >
$ pip install <a target='tab' href='https://pypi.org/project/cx-Oracle/'>cx_Oracle</a>
</pre>
 
네이티브 모듈도 함께 설치를 해야 합니다. 
 
<pre style='margin: 10px 0px 10px 10px; padding: 10px 0px 10px 10px; background-color: #fbedbb; overflow: auto; font-family: Consolas, Verdana;' >
// cx_Oracle 8 Installation
// ; <a target='tab' href='https://cx-oracle.readthedocs.io/en/latest/user_guide/installation.html'>https://cx-oracle.readthedocs.io/en/latest/user_guide/installation.html</a>

$ 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
</pre>
 
위와 같이만 구성해 주면 이제 cx_Oracle.connect에 적절한 연결 정보를 전달해 실행할 수 있습니다. 예를 들어, <a target='tab' href='https://www.sysnet.pe.kr/2/0/10928'>닷넷의 경우</a> 이렇게 연결 문자열을 구성했다면, 
 
<pre style='margin: 10px 0px 10px 10px; padding: 10px 0px 10px 10px; background-color: #fbedbb; overflow: auto; font-family: Consolas, Verdana;' >
Data Source=(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=192.168.100.50)(PORT=1521))(CONNECT_DATA=(SERVICE_NAME=XE)));User Id=hr;Password=hrpass;
</pre>
 
파이썬에서도 유사하게 이런 식으로 전달하면 됩니다. 
 
<pre style='margin: 10px 0px 10px 10px; padding: 10px 0px 10px 10px; background-color: #fbedbb; overflow: auto; font-family: Consolas, Verdana;' >
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)
</pre>
 
혹은 좀 더 약식으로 id, password 및 "HOST:PORT/SERVICE_NAME" 형식으로 다음과 같이 연결 테스트를 할 수 있습니다. 
 
<pre style='margin: 10px 0px 10px 10px; padding: 10px 0px 10px 10px; background-color: #fbedbb; overflow: auto; font-family: Consolas, Verdana;' >
import cx_Oracle
oc = cx_Oracle.connect('hr', 'hrpass', '192.168.100.50:1521/XE')
</pre>
 
<hr style='width: 50%' /> 
 
참고로, dockerfile로 구성한다면 instantclient-basic-linux.x64-21.6.0.0.0dbru.zip 파일을 dockerfile 위치에 미리 복사해 둔 후 (혹은 그것조차도 dockerfile에서 wget으로 받아두거나) 이런 식으로 구성하면 됩니다. 
 
<pre style='margin: 10px 0px 10px 10px; padding: 10px 0px 10px 10px; background-color: #fbedbb; overflow: auto; font-family: Consolas, Verdana;' >
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 &gt; /etc/ld.so.conf.d/oracle-instantclient.conf"
RUN ldconfig
...[생략]...
</pre>
 
이후의 python 내에서 사용하는 방법은 일반적인 <a target='tab' href='https://peps.python.org/pep-0249/'>dbapi2 인터페이스</a>를 따릅니다. 
 
<hr style='width: 50%' /> 
 
혹시나 다음과 같은 오류가 발생한다면? 
 
<pre style='margin: 10px 0px 10px 10px; padding: 10px 0px 10px 10px; background-color: #fbedbb; overflow: auto; font-family: Consolas, Verdana;' >
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
</pre>
 
네이티브 모듈(instantclient-basic-linux.x64-21.6.0.0.0dbru.zip)을 설치하지 않아서 그런 것입니다. 
 
 
참고로, 네이티브 모듈 없이 cx_Oracle 패키지만 내려받아 사용하면 cx_Oracle.connect는 (오류 없이) None을 반환합니다. 그런 탓에 None 체크 없이 곧바로 cursor를 사용하려는 경우, 
 
<pre style='margin: 10px 0px 10px 10px; padding: 10px 0px 10px 10px; background-color: #fbedbb; overflow: auto; font-family: Consolas, Verdana;' >
import cx_Oracle
con = cx_Oracle.connect('...', '...', '...')
cursor = con.cursor()
</pre>
 
이런 오류가 발생할 수 있습니다. 
 
<pre style='margin: 10px 0px 10px 10px; padding: 10px 0px 10px 10px; background-color: #fbedbb; overflow: auto; font-family: Consolas, Verdana;' >
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'
</pre>
 
또는 with 문과 사용한다면, 
 
<pre style='margin: 10px 0px 10px 10px; padding: 10px 0px 10px 10px; background-color: #fbedbb; overflow: auto; font-family: Consolas, Verdana;' >
import cx_Oracle

with cx_Oracle.connect(user='...', password='...', dsn='...') as con:
 with con.cursor() as cursor:
 pass
</pre>
 
connect 문에서 다음과 같은 예외가 발생합니다. 
 
<pre style='margin: 10px 0px 10px 10px; padding: 10px 0px 10px 10px; background-color: #fbedbb; overflow: auto; font-family: Consolas, Verdana;' >
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__
</pre>

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

</div>

첨부파일

스팸 방지용 인증 번호

1102 (왼쪽의 숫자를 입력해야 합니다.)