>>> import cx_Oracle >>> db = cx_Oracle.connect(‘hr‘, ‘hrpwd‘, ‘localhost:1521/XE‘) >>> db1 = cx_Oracle.connect(‘hr/hrpwd@localhost:1521/XE‘) >>> dsn_tns = cx_Oracle.makedsn(‘localhost‘, 1521, ‘XE‘) >>> print dsn_tns (DESCRIPTION=(ADDRESS_LIST=(ADDRESS=(PROTOCOL=TCP)(HOST=localhost)(PORT=1521)))(CONNECT_DATA=(SID=XE))) >>> db2 = cx_Oracle.connect(‘hr‘, ‘hrpwd‘, dsn_tns)
# 通过客户端连接oracle
connection = cx_Oracle.connect(‘test/test@ORCL‘)
回到顶部
第二步:建立 Cursor 光标,查询
您可以使用连接对象的 cursor() 方法定义任意数量的游标。简单的程序使用一个游标就可以了,该游标可以一再地重复使用。但较大的项目可能要求几个不同的游标。
>>> cursor = db.cursor()
应用程序逻辑通常需要明确区分针对数据库发出的语句的各个处理阶段。这有助于更好地理解性能瓶颈并编写更快且经过优化的代码。语句处理分三个阶段:
- 分析(可选)
- cx_Oracle.Cursor.parse([statement])
实际上并不需要调用,因为在执行阶段会自动分析 SQL 语句。该方法可以用于在执行语句前对其进行验证。当这类语句中检测出错误时,会引发 DatabaseError 异常,相应的错误消息通常可能是“ORA-00900:invalid SQL statement, ORA-01031:insufficient privileges or ORA-00921:unexpected end of SQL command.”
- cx_Oracle.Cursor.parse([statement])
- 执行
- cx_Oracle.Cursor.execute(statement, [parameters], **keyword_parameters)
此方法可以接受单个参数 — 一条 SQL 语句 — 直接针对数据库来运行。通过 parameters 或 keyword_parameters 参数赋值的绑定变量可以指定为字典、序列或一组关键字参数。如果已经提供了字典或关键字参数,那么这些值将与名称绑定。如果给出的是序列,将根据这些值的位置对它们进行解析。如果是查询操作,此方法返回一个变量对象列表;如果不是,则返回 None。 - cx_Oracle.Cursor.executemany(statement, parameters)
对于批量插入尤其有用,因为它可以将所需的 Oracle 执行操作的数量限制为仅一个。有关如何使用该方法的详细信息,请参见下面的“一次多行”部分。
- cx_Oracle.Cursor.execute(statement, [parameters], **keyword_parameters)
- 获取(可选)— 仅用于查询(因为 DDL 和 DCL 语句不返回结果)。在不执行查询的游标上,这些方法将引发 InterfaceError 异常。
- cx_Oracle.Cursor.fetchall()
以字节组列表形式获取结果集中的所有剩余行。如果没有剩余的行,它返回一个空白列表。获取操作可以通过设置游标的 arraysize 属性进行调整,该属性可设置在每个底层请求中从数据库中返回的行数。arraysize 的设置越高,需要在网络中往返传输的次数越少。arraysize 的默认值为 1。 - cx_Oracle.Cursor.fetchmany([rows_no])
获取数据库中接下来的 rows_no 行。如果该参数未指定,该方法获取的行数是 arraysize 的数量。如果 rows_no 大于获取到的行的数目,该方法获取的行数是剩余的行数。 - cx_Oracle.Cursor.fetchone()
从数据库中获取单个字节组,如果没有剩余行,则返回 none。
- cx_Oracle.Cursor.fetchall()
在继续了解游标示例前,请先了解 pprint 模块的 pprint 函数。它用于以清晰、可读的形式输出 Python 数据结构。
# 获得游标对象 cursor = connection.cursor () try: # 解析sql语句 cursor.parse("select * dual") # 捕获SQL异常 except cx_Oracle.DatabaseError as e: print(e) # ORA-00923: 未找到要求的 FROM 关键字 # 执行sql 语句 cursor.execute ("select * from dual") # 提取一条数据,返回一个元祖 row = cursor.fetchone() pprint(row) # (‘X‘,)
回到顶部
数据类型
在获取阶段,基本的 Oracle 数据类型会映射到它们在 Python 中的等同数据类型中。cx_Oracle 维护一个单独的、有助于这一转换的数据类型集合。Oracle - cx_Oracle - Python 映射为

查询列字段信息
# 查询列字段信息 column_data_types = cursor.execute(‘SELECT * FROM python_modules‘) pprint(column_data_types.description) # [(‘MODULE_NAME‘, <class ‘cx_Oracle.STRING‘>, 50, 50, None, None, 0), # (‘FILE_PATH‘, <class ‘cx_Oracle.STRING‘>, 300, 300, None, None, 0)]
回到顶部
绑定变量模式
正如 Oracle 大师 Tom Kyte 介绍的那样,绑定变量是数据库开发的核心原则。它们不仅使程序运行更快,同时可以防范 SQL 注入攻击。
按名称传递绑定变量要求执行方法的 parameters 参数是一个字典或一组关键字参数。下面的 query1 和 query2 是等同的: >>> named_params = {‘dept_id‘:50, ‘sal‘:1000} >>> query1 = cursor.execute(‘SELECT * FROM employees WHERE department_id=:dept_id AND salary>:sal‘, named_params) >>> query2 = cursor.execute(‘SELECT * FROM employees WHERE department_id=:dept_id AND salary>:sal‘, dept_id=50, sal=1000) 在使用已命名的绑定变量时,您可以使用游标的 bindnames() 方法检查目前已指定的绑定变量: >>> print cursor.bindnames() [‘DEPT_ID‘, ‘SAL‘] # 绑定变量模式查询 named_params = {‘MODULE_NAME‘: ‘cx_Oracle‘} cursor.execute(‘SELECT * FROM python_modules where MODULE_NAME =:MODULE_NAME‘,named_params) # 在使用已命名的绑定变量时,您可以使用游标的 bindnames() 方法检查目前已指定的绑定变量: print(cursor.bindnames()) pprint(cursor.fetchone()) # (‘cx_Oracle‘, # ‘C:\\Program ‘ # ‘Files\\Python36\\lib\\site-packages\\cx_Oracle.cp36-win_amd64.pyd‘) # 在绑定时,您可以首先准备该语句,然后利用改变的参数执行 None。 # 根据绑定变量时准备一个语句即足够这一原则, # Oracle 将如同在上例中一样对其进行处理。准备好的语句可执行任意次。 cursor.prepare(‘SELECT * FROM python_modules where MODULE_NAME =:MODULE_NAME‘) cursor.execute(None, named_params) pprint(cursor.fetchone()) # (‘cx_Oracle‘, # ‘C:\\Program ‘ # ‘Files\\Python36\\lib\\site-packages\\cx_Oracle.cp36-win_amd64.pyd‘)
回到顶部
一次多行
大型的插入操作不需求多次的单独插入,这是因为 Python 通过 cx_Oracle.Cursor.executemany 方法完全支持一次插入多行。
限制执行操作的数量极大地改善了程序性能,因此在编写存在大量插入操作的应用程序时应首先考虑这一功能。
我们首先为 Python 模块列表创建一个表,这次直接从 Python 开始。您将在以后删除该表。
import cx_Oracle # 用于以清晰、可读的形式输出 Python 数据结构 from pprint import pprint from sys import modules # 通过客户端连接oracle connection = cx_Oracle.connect(‘test/test@testDB‘) print(connection.version) # 获得游标对象 cursor = connection.cursor () try: # 解析sql语句 cursor.parse("select * dual") # 捕获SQL异常 except cx_Oracle.DatabaseError as e: print(e) # ORA-00923: 未找到要求的 FROM 关键字 # 执行sql 语句 cursor.execute ("select * from dual") # 提取一条数据,返回一个元祖 row = cursor.fetchone() pprint(row) # (‘X‘,) create_table = """ CREATE TABLE python_modules ( module_name VARCHAR2(50) NOT NULL, file_path VARCHAR2(300) NOT NULL ) """ # 执行创建表 create_flag = cursor.execute(create_table) # 添加模块信息 M = [] for m_name, m_info in modules.items(): try: M.append((m_name, m_info.__file__)) except AttributeError: pass print(len(M)) insert_sql = "INSERT INTO python_modules(module_name, file_path) VALUES (:1, :2)" # 在prepare之后,你再去execute的时候,就不用写上sql语句参数了 cursor.prepare(insert_sql) cursor.executemany(None, M) # 注意,第一个参数是None connection.commit() # 提交 # 查询 r = cursor.execute("SELECT COUNT(*) FROM python_modules") pprint(cursor.fetchone()) # 查询列字段信息 column_data_types = cursor.execute(‘SELECT * FROM python_modules‘) pprint(column_data_types.description) # [(‘MODULE_NAME‘, <class ‘cx_Oracle.STRING‘>, 50, 50, None, None, 0), # (‘FILE_PATH‘, <class ‘cx_Oracle.STRING‘>, 300, 300, None, None, 0)] # 取10条记录信息 pprint(len(cursor.fetchmany(10))) # 10 # 取之后所有记录信息,不包括前10条 pprint(len(cursor.fetchall())) # 41 # 绑定变量模式查询 named_params = {‘MODULE_NAME‘: ‘cx_Oracle‘} cursor.execute(‘SELECT * FROM python_modules where MODULE_NAME =:MODULE_NAME‘,named_params) # 在使用已命名的绑定变量时,您可以使用游标的 bindnames() 方法检查目前已指定的绑定变量: print(cursor.bindnames()) pprint(cursor.fetchone()) # (‘cx_Oracle‘, # ‘C:\\Program ‘ # ‘Files\\Python36\\lib\\site-packages\\cx_Oracle.cp36-win_amd64.pyd‘) # 在绑定时,您可以首先准备该语句,然后利用改变的参数执行 None。 # 根据绑定变量时准备一个语句即足够这一原则, # Oracle 将如同在上例中一样对其进行处理。准备好的语句可执行任意次。 cursor.prepare(‘SELECT * FROM python_modules where MODULE_NAME =:MODULE_NAME‘) cursor.execute(None, named_params) pprint(cursor.fetchone()) # (‘cx_Oracle‘, # ‘C:\\Program ‘ # ‘Files\\Python36\\lib\\site-packages\\cx_Oracle.cp36-win_amd64.pyd‘) # 删除python_modules cursor.execute("DROP TABLE python_modules PURGE") # 关闭游标 cursor.close() # 关闭连接 connection.close () # BLOB & CLOB 格式的创建: # # binary_content = cursor.var(cx_Oracle.BLOB) # binary_content.setvalue(0, content)
Oracle——python的基本操作
标签:开发 基类 数据库驱动 cti site intern 阅读 标示 ima