Python连接Oracle数据库的实用方法与封装类实现

Miles
Miles
发布时间:2026-10-13 | 5人浏览过
原创

本文介绍Python通过cx_Oracle库连接Oracle数据库的多种方法。重点解析当配置项中无SID时,如何直接使用tnsnames.ora中的SERVICE_NAME配置进行连接。同时提供完整的连接示例代码及一个封装好的Oracle操作类,涵盖查询、更新及资源释放功能,帮助开发者简化数据库交互流程。

本文分享Python操作Oracle数据库的基础方法及一个封装类示例,供读者参考学习。

近期工作中涉及Oracle数据库,发现使用Python脚本处理相关任务能显著提升效率,因此决定先掌握Python连接Oracle的基本技巧。

考虑到Oracle通常依赖OracleClient的NetConfig进行配置,起初认为建立连接并非易事。

尝试了网上几种常见的连接方式,但经过反复调试,始终未能成功建立连接。

方法一:将用户名、密码和监听地址作为独立参数传入。

conn=cx_Oracle.connect('用户名','密码','数据库地址:数据库端口/SID')

结合查阅的资料及代码报错信息,推测Python连接数据库的配置应与Oracle客户端的tnsnames.ora文件相关。然而,我的配置文件中并未包含SID字段,且起初也不了解SID的具体含义,盲目照搬网络教程导致失败。后来意识到需在配置中添加SID,但考虑到修改配置后可能需要重启系统,因此决定先探索其他无需修改配置的替代方案。

方法二:将用户名、密码和监听信息合并为一个参数传入。

conn=cx_Oracle.connect('用户名/密码@数据库地址:数据库端口/SID')

此方法在本质上与方法一相同,只是参数传递形式略有差异,并未解决根本问题。

方法三:直接使用TNS配置信息字符串。

conn=cx_Oracle.connect('用户名','密码',tns)

网络上的示例代码通常通过函数生成TNS字符串,该过程依然依赖SID。由于我的可用配置项中不含SID,因此尝试直接利用现有配置信息。

tns=cx_Oracle.makedsn('数据库地址','数据库端口', 'SID')

该方法仍未成功,但通过观察TNS字符串的生成逻辑,发现其与前述两种方法类似。当我随意输入一个SID时,生成的字符串结构如下。

(DESCRIPTION=(ADDRESS_LIST=(ADDRESS=(PROTOCOL=TCP)(HOST=127.0.0.1)(PORT=1521)))(CONNECT_DATA=(SID=XE)))

而我的客户端实际配置大致如下所示。

(DESCRIPTION=(ADDRESS_LIST=(ADDRESS=(PROTOCOL=TCP)(HOST=127.0.0.1)(PORT=1521)))(CONNECT_DATA=(SERVICE_NAME=KGDB)))

注意到两者结构相似,且均为字符串类型,于是尝试将配置文件中的完整配置项直接赋值给tns变量进行连接测试。

tns = '(DESCRIPTION=(ADDRESS_LIST=(ADDRESS=(PROTOCOL=TCP)(HOST=127.0.0.1)(PORT=1521)))(CONNECT_DATA=(SERVICE_NAME=KGDB)))'
conn = cx_Oracle.connect('nicker', '123456', tns)

测试结果显示连接成功。

以下是完整的连接使用方法代码示例。

#coding:utf-8
import cx_Oracle
# 创建数据库连接
# cx_Oracle.connect('username','pwd','ora的tns信息')
# oracle数据库的tns信息,从tnsnames.ora中找到plsql可用的配置项,将该配置项直接拷贝过来即可
ora_tns = '(DESCRIPTION=(ADDRESS_LIST=(ADDRESS=(PROTOCOL=TCP)(HOST=127.0.0.1)(PORT=1521)))(CONNECT_DATA=(SERVICE_NAME=KGDB)))'
conn = cx_Oracle.connect('nicker', '123456', ora_tns)
# 操作游标
cursor = conn.cursor()
# 执行查询
cursor.execute("SELECT * FROM inst_info")
# 获取返回信息
rs = cursor.fetchall()
# 输出信息
for v in rs:
  print v
#关闭连接,释放资源
cursor.close()
conn.close()

通过实践可以发现,总结关键点并深入理解原理至关重要。

在此基础上,提供一个封装好的Oracle数据库操作类。

#coding:utf-8
import cx_Oracle
# 封装的类
class cxOracle:
  '''
  tns的取值tnsnames.ora对应的配置项的值,如:
  tns = '(DESCRIPTION=(ADDRESS_LIST=(ADDRESS=(PROTOCOL=TCP)(HOST=10.16.18.23)(PORT=1521)))(CONNECT_DATA=(SERVICE_NAME=MYDB)))'
  '''
  def __init__(self ,uname, upwd,tns ):
    self ._uname = uname
    self ._upwd = upwd
    self ._tns = tns
    self ._conn = None
    self ._ReConnect()
  def _ReConnect(self ):
    if not self._conn :
      self ._conn = cx_Oracle.connect (self. _uname, self ._upwd, self._tns)
    else:
      pass
  def __del__(self ):
    if self. _conn:
      self ._conn. close()
      self ._conn = None
  def _NewCursor(self ):
    cur = self. _conn.cursor ()
    if cur:
      return cur
    else:
      print "#Error# Get New Cursor Failed."
      return None
  def _DelCursor(self , cur):
    if cur:
      cur .close()
  # 检查是否允许执行的sql语句
  def _PermitedUpdateSql(self ,sql):
    rt = True
    lrsql = sql. lower()
    sql_elems = [ lrsql.strip ().split()]
    # update和delete最少有四个单词项
    if len( sql_elems) < 4 :
      rt = False
    # 更新删除语句,判断首单词,不带where语句的sql不予执行
    elif sql_elems[0] in [ 'update', 'delete']:
      if 'where' not in sql_elems :
        rt = False
    return rt
  # 导出结果为文件
  def Export(self , sql, file_name, colfg ='||'):
    rt = self. Query(sql )
    if rt:
      with open( file_name, 'a') as fd:
        for row in rt:
          ln_info = ''
          for col in row:
             ln_info += str( col) + colfg
          ln_info += '\n'
          fd .write( ln_info)
  # 查询
  def Query(self , sql, nStart=0 , nNum=- 1):
    rt = []
    # 获取cursor
    cur = self. _NewCursor()
    if not cur:
      return rt
    # 查询到列表
    cur .execute(sql)
    if ( nStart==0 ) and (nNum==1 ):
      rt .append( cur.fetchone ())
    else:
      rs = cur. fetchall()
      if nNum==- 1:
        rt .extend( rs[nStart:])
      else:
        rt .extend( rs[nStart:nStart +nNum])
    # 释放cursor
    self ._DelCursor(cur)
    return rt
  # 更新
  def Exec(self ,sql):
    # 获取cursor
    rt = None
    cur = self. _NewCursor()
    if not cur:
      return rt
    # 判断sql是否允许其执行
    if not _PermitedUpdateSql(sql ):
      return rt
    # 执行语句
    rt = cur. execute(sql )
    # 释放cursor
    self ._DelCursor(cur)
    return rt
# 类使用示例
tns = '(DESCRIPTION=(ADDRESS_LIST=(ADDRESS=(PROTOCOL=TCP)(HOST=10.16.17.46)(PORT=1521)))(CONNECT_DATA=(SERVICE_NAME=MYDB)))'
ora = cxOracle ('nicker', '123456', tns)
# 导出结果为文件
rs = ora .Export("SELECT * FROM org", '1.txt')
# 查询结果到列表
rs = ora.Query("SELECT * FROM org")
print rs
# 更新数据
ora.Exec("update org set org_name='NewNameForUpdate' where org_id=123456;")

如需了解更多Python相关知识,可参考本站专题:《Python常见数据库操作技巧汇总》、《Python编码操作技巧总结》、《Python数据结构与算法教程》、《Python Socket编程技巧总结》、《Python函数使用技巧总结》、《Python字符串操作技巧汇总》、《Python入门与进阶经典教程》及《Python文件与目录操作技巧汇总》。

希望本文的内容能对从事Python程序设计的读者有所帮助。

本站声明

本文内容仅供参考,不代表本站观点。转载或引用请注明出处。如发现内容问题,请通过联系我们页面反馈。

Python 相关产品和应用

全部下载

专题列表