cx_Oralce - 操作 Oracle 数据库

2022/1/9大约 4 分钟python数据库

cx_Oralce - 操作 Oracle 数据库

一、概述

cx_Oracle是一个用于Python语言与Oracle数据库进行交互的强大第三方库。它提供了高效的方式来连接Oracle数据库，执行SQL语句（包括查询、插入、更新和删除等操作），并且能够处理数据库返回的结果集。通过cx_Oracle，开发者可以在Python应用程序中充分利用Oracle数据库的功能。

二、pip安装

检查必要的依赖
- 首先，确保系统已经安装了Oracle客户端库。cx_Oracle需要依赖Oracle客户端库来与数据库进行通信。不同的操作系统有不同的安装方式，例如在Linux系统中，可能需要安装oracle - instantclient - basic等相关软件包；在Windows系统中，需要下载并安装Oracle Instant Client。
安装cx_Oracle
- 安装cx_Oracle，在命令行中执行pip install cx_Oracle。等待安装完成后，就可以在Python代码中使用该库了。

三、简单示例

连接Oracle数据库并查询数据
```
import cx_Oracle

# 连接数据库信息
connection_string = "user/password@host:port/service_name"
try:
    # 建立连接
    connection = cx_Oracle.connect(connection_string)
    # 创建游标
    cursor = connection.cursor()
    # 执行SQL查询语句
    sql_query = "SELECT * FROM your_table"
    cursor.execute(sql_query)
    # 获取查询结果
    results = cursor.fetchall()
    for row in results:
        print(row)
    # 关闭游标和连接
    cursor.close()
    connection.close()
except cx_Oracle.Error as error:
    print("数据库操作出错: ", error)
```
- 在这个示例中：
  - 首先导入cx_Oracle库。
  - 定义了连接数据库的字符串connection_string，其中包含用户名、密码、主机地址、端口和服务名等信息，需要根据实际情况修改。
  - 使用connect方法建立与数据库的连接。如果连接成功，会返回一个connection对象。
  - 通过connection对象创建游标cursor，游标用于执行SQL语句并处理结果。
  - 执行查询语句SELECT * FROM your_table，可以根据实际需求修改查询内容。
  - 使用fetchall方法获取查询结果，结果是一个包含所有行的元组列表，然后遍历并打印这些行。
  - 最后，关闭游标和连接，释放资源。如果在操作过程中出现错误，会捕获cx_Oracle.Error异常并打印错误信息。

插入数据示例

import cx_Oracle

# 连接数据库信息
connection_string = "user/password@host:port/service_name"
try:
    # 建立连接
    connection = cx_Oracle.connect(connection_string)
    # 创建游标
    cursor = connection.cursor()
    # 插入数据的SQL语句
    sql_insert = "INSERT INTO your_table (column1, column2) VALUES (:value1, :value2)"
    values = {'value1': 'data1', 'value2': 'data2'}
    cursor.execute(sql_insert, values)
    # 提交事务
    connection.commit()
    # 关闭游标和连接
    cursor.close()
    connection.close()
except cx_Oracle.Error as error:
    print("插入数据出错: ", error)

此示例用于向数据库中插入数据：
- 连接数据库的步骤与查询示例相同。
- 定义插入数据的SQL语句，这里使用了命名参数（:value1和:value2），这种方式可以更清晰地将参数与SQL语句结合，也有助于防止SQL注入。
- 定义一个字典values，其中包含要插入的值，键与SQL语句中的命名参数相对应。
- 执行插入操作，将SQL语句和参数值传递给cursor.execute方法。
- 插入数据后需要提交事务，通过connection.commit()来完成。
- 最后关闭游标和连接。

四、常见注意事项

数据库连接配置
- 确保connection_string中的信息（用户名、密码、主机、端口和服务名）准确无误。连接Oracle数据库时，服务名的配置可能因数据库版本和部署方式而有所不同，需要根据实际情况确定。
字符编码
- Oracle数据库有自己的字符编码体系。在处理数据时，要注意数据库字符编码与Python程序中的编码设置一致，避免出现乱码问题。特别是在插入和读取包含中文或其他特殊字符的数据时，可能需要进行编码转换操作。
SQL注入防范
- 像在插入数据示例中展示的一样，尽量使用参数化的SQL语句（如命名参数或位置参数）来防止SQL注入。避免直接拼接用户输入的内容到SQL语句中，否则可能会导致安全漏洞。
资源管理
- 连接和游标是占用数据库资源的对象。在使用完后，一定要及时关闭游标和连接，以避免资源浪费和潜在的数据库性能问题。如果在一个函数或代码块中使用cx_Oracle，可以考虑使用try - finally或者with语句来确保资源的正确释放。例如，可以使用with cx_Oracle.connect(connection_string) as connection:的方式来自动管理连接的关闭。