Devcafe: 핵심 정리 항목 추가

2026-11-12T03:22:59Z

핵심 정리 항목 추가

← 이전 판		2026년 11월 12일 (목) 12:22 판
1번째 줄:		1번째 줄:
	{{개발노트		{{개발노트
	\|요약=python-oracledb Thin 모드로 Oracle 19c에 접속하고 쿼리를 실행하는 기본 예제		\|요약=python-oracledb Thin 모드로 Oracle 19c에 접속하고 쿼리를 실행하는 기본 예제
			\|핵심=Thin 모드는 Oracle Client 설치 없이 바로 접속할 수 있다
			with 문을 쓰면 커서와 연결이 자동으로 닫힌다
			쿼리 값은 반드시 바인드 변수(:name)로 넘긴다
			접속 오류는 리스너 상태와 서비스명부터 확인한다
	\|분야=Python		\|분야=Python
	\|난이도=초급		\|난이도=초급

Devcafe: 개발노트 양식 테스트 문서

2026-11-12T03:12:52Z

개발노트 양식 테스트 문서

새 문서

{{개발노트
|요약=python-oracledb Thin 모드로 Oracle 19c에 접속하고 쿼리를 실행하는 기본 예제
|분야=Python
|난이도=초급
|환경=Windows 11 / Python 3.12 / Oracle 19c
|키워드=oracledb, Oracle, DB 접속
|작성일=2026-11-12
}}
== 개요 ==
'''python-oracledb'''는 cx_Oracle의 후속 드라이버입니다. 기본값인 '''Thin 모드'''는 Oracle Client(Instant Client) 설치 없이 바로 접속할 수 있어 간단한 자동화 스크립트에 적합합니다.

== 준비 사항 ==
* Python 3.8 이상
* 패키지 설치: <code>pip install oracledb</code>
* 접속 정보: 호스트, 포트, 서비스명, 계정

== 본문 ==
=== 1단계 : 접속 ===
<code>oracledb.connect()</code>에 계정과 DSN(<code>호스트:포트/서비스명</code>)을 넘깁니다.

=== 2단계 : 쿼리 실행 ===
<code>with</code> 문을 쓰면 커서와 연결이 자동으로 닫힙니다. 값은 반드시 '''바인드 변수'''로 넘기세요.

== 예제 코드 ==
<syntaxhighlight lang="python">
import oracledb

dsn = "dbhost:1521/ORCLPDB"

with oracledb.connect(user="scott", password="tiger", dsn=dsn) as conn:
print("DB 버전:", conn.version)
with conn.cursor() as cur:
cur.execute("SELECT ename, sal FROM emp WHERE deptno = :d", d=10)
for ename, sal in cur:
print(ename, sal)
</syntaxhighlight>

== 문제 해결 ==
{| class="wikitable"
! 증상 !! 원인 !! 해결 방법
|-
| DPY-6005 / ORA-12541 || 리스너 미기동 또는 포트 차단 || <code>lsnrctl status</code>, 방화벽 확인
|-
| ORA-12514 || 서비스명 오류 || <code>lsnrctl services</code>로 서비스명 확인
|-
| DPY-3015 || 구버전 DB의 비밀번호 검증자(10G) || 비밀번호 재설정 또는 Thick 모드 사용
|}

== 참고 자료 ==
* [https://python-oracledb.readthedocs.io/ python-oracledb 공식 문서]

개발노트 테스트 - 편집 역사

Devcafe: 핵심 정리 항목 추가

Devcafe: 개발노트 양식 테스트 문서