環境準備
- 安裝 Oracle Instant Client(Basic + SDK)。
pip install cx_Oracle(需編譯環境或下載 wheel)。
- 設置環境變量
LD_LIBRARY_PATH (Linux) 或 PATH (Windows) 指向 Instant Client 目錄。
基本查詢
import cx_Oracle
def query_demo():
# 連接字符串:user/pwd@host:port/service_name
dsn = cx_Oracle.makedsn('localhost', 1521, service_name='ORCL')
conn = cx_Oracle.connect(user='scott', password='tiger', dsn=dsn)
print(f"Oracle Version: {conn.version}")
cur = conn.cursor()
try:
cur.execute('SELECT * FROM wlan_future_event')
for row in cur:
print(row)
finally:
cur.close()
conn.close()
if __name__ == '__main__':
query_demo()
最佳實踐
- 使用
with 上下文管理器自動關閉連接/游標(cx_Oracle 7.2+ 支持)。
- 綁定變量防注入:
cur.execute("SELECT * FROM t WHERE id = :id", id=100)。
- 批量操作:
cur.executemany、cur.arrayvar 提升性能。
- 連接池:
cx_Oracle.SessionPool 管理連接生命週期。
- 異常處理:捕獲
cx_Oracle.DatabaseError 解析錯誤碼。
常見問題
DPI-1047:未找到 Oracle Client 库 → 檢查環境變量與架構匹配(32/64位)。
- 編碼亂碼:連接時指定
encoding="UTF-8", nencoding="UTF-8"。