`python-oracledb` 的 `cursor.var()` 方法用于创建客户端绑定变量。这些变量是 Python 对象，其值在客户端内存中维护，并不会因数据库连接的关闭而自动丢失。只有当变量通过游标执行 SQL 语句时，其值才与数据库会话进行交互。理解这一客户端与服务器端的区别，对于正确管理数据持久性和连接至关重要。
在使用 python-oracledb 与 Oracle 数据库交互时，cursor 对象扮演着核心角色，它是执行 SQL 语句、管理事务以及获取查询结果的接口。cursor.var() 方法则用于创建绑定变量，这些变量在 SQL 语句中作为占位符，可以动态地传递数据到数据库或从数据库接收数据。
绑定变量的主要优势包括：
理解 python-oracledb 中对象的工作原理，首先需要明确数据库连接、会话和游标的生命周期：
立即学习“Python免费学习笔记（深入）”；
关键点： 当您调用 connection.close() 时，不仅会关闭客户端与数据库的网络连接，还会终止服务器上的相应数据库会话。这意味着与该会话关联的所有服务器端资源（包括数据库内部的游标状态、PL/SQL 包变量等）都会被释放。每次重新调用 oracledb.connect() 都会建立一个全新的连接，并创建一个全新的、独立的数据库会话。
cursor.var() 方法返回的是一个 oracledb.Var 类型的 Python 对象。这个对象存在于您的 Python 应用程序的内存中，而不是数据库服务器的内存中。
因此，即使您关闭了数据库连接（从而终止了数据库会话），只要持有 oracledb.Var 对象的 Python 变量仍然在作用域内并且没有被重新赋值，它在客户端内存中的值就会继续存在。这解释了为什么在重新连接后，您仍然可以访问之前设置的值。您访问的仅仅是客户端 Python 对象的状态，而不是数据库服务器上任何持久化的会话状态。
让我们通过一个修正后的示例来清晰地展示这一点。原始问题中的代码之所以看似“维持”了值，是因为它重复使用了同一个 Python 变量 host_variable。
import oracledb
import connection_config # 假设 connection_config 包含数据库凭据
# --- 第一次连接和变量操作 ---
print("--- 第一次连接 ---")
con1 = oracledb.connect(user=connection_config.user, password=connection_config.pw, dsn=connection_config.dsn)
cursor1 = con1.cursor()
# 创建第一个客户端变量对象
host_variable1 = cursor1.var(str)
host_variable1.setvalue(0, 'VALUE_FROM_SESSION_1')
print(f"host_variable1 的当前值 (客户端): {host_variable1.getvalue()}") # 输出: VALUE_FROM_SESSION_1
# 关闭第一个连接，终止第一个数据库会话
con1.close()
print("连接 con1 已关闭。")
# --- 第二次连接和变量操作 ---
print("\n--- 第二次连接 ---")
con2 = oracledb.connect(user=connection_config.user, password=connection_config.pw, dsn=connection_config.dsn)
cursor2 = con2.cursor()
# 尝试访问 host_variable1 的值
# 注意：host_variable1 仍然是 Python 内存中的一个对象
print(f"关闭 con1 后 host_variable1 的值 (客户端): {host_variable1.getvalue()}")
# 预期输出: VALUE_FROM_SESSION_1。这表明 Python 对象本身的值未丢失。
# 创建第二个客户端变量对象
host_variable2 = cursor2.var(str)
print(f"新创建的 host_variable2 的值 (客户端): {host_variable2.getvalue()}")
# 预期输出: None 或空字符串。因为这是一个全新的 Python 对象，尚未赋值。
# 尝试用 host_variable1 与新连接的游标进行交互 (例如，绑定到 SQL)
# 虽然 host_variable1 存在，但它最初是与 cursor1 关联的。
# 在实际使用中，你需要将它重新绑定到 cursor2，或者直接使用 host_variable2。
# 例如，如果直接尝试用 host_variable1 绑定到 cursor2 的执行，可能会出现逻辑错误或需要重新绑定。
con2.close()
print("连接 con2 已关闭。")分析上述代码：
如果您确实需要在不同的数据库连接/会话之间维护数据，cursor.var() 并不是直接的解决方案。您有以下几种选择：
客户端 Python 变量： 最简单直接的方法是将数据存储在常规的 Python 变量、列表、字典或其他数据结构中。这些数据在您的 Python 应用程序内存中，只要应用程序运行，它们就保持不变，并且可以在不同的数据库连接之间传递和使用。
# 示例：在 Python 变量中存储数据
client_data = 'Persistent_Value_in_Python'
# 第一次连接
with oracledb.connect(user=connection_config.user, password=connection_config.pw, dsn=connection_config.dsn) as con1:
cursor1 = con1.cursor()
# 使用 client_data
print(f"第一次连接中使用客户端数据: {client_data}")
# 第二次连接
with oracledb.connect(user=connection_config.user, password=connection_config.pw, dsn=connection_config.dsn) as con2:
cursor2 = con2.cursor()
# 再次使用 client_data
print(f"第二次连接中使用客户端数据: {client_data}")Oracle 数据库中的包变量 (Package Variables)： 在 Oracle 数据库中，您可以使用 PL/SQL 包来定义包级变量。这些变量的值在同一个数据库会话中是持久的，即在会话生命周期内，所有对该包的调用都可以访问和修改这些变量。但请注意，它们仍然是会话绑定的，当会话终止时，变量值也会丢失。这不适用于跨不同数据库连接的持久性。
将数据持久化到数据库表： 如果数据需要在不同的会话甚至应用程序重启后仍然可用，最可靠的方法是将其存储在 Oracle 数据库的表中。使用 INSERT、UPDATE 或 MERGE 语句将数据写入表中，然后在需要时从表中读取。
-- 示例：创建表来存储持久化数据
CREATE TABLE my_persistent_data (
id NUMBER PRIMARY KEY,
value VARCHAR2(100)
);# 示例：将数据插入表中
with oracledb.connect(user=connection_config.user, password=connection_config.pw, dsn=connection_config.dsn) as con:
cursor = con.cursor()
cursor.execute("INSERT INTO my_persistent_data (id, value) VALUES (1, :data)", data='Truly_Persistent_Value')
con.commit()
# 在另一个连接或程序运行时读取数据
with oracledb.connect(user=connection_config.user, password=connection_config.pw, dsn=connection_config.dsn) as con:
cursor = con.cursor()
cursor.execute("SELECT value FROM my_persistent_data WHERE id = 1")
result = cursor.fetchone()
print(f"从数据库表中读取的持久化数据: {result[0]}")通过深入理解这些基本概念，您可以更有效地使用 python-oracledb 进行开发，并避免因对底层机制的误解而导致的问题。
以上就是深入理解 python-oracledb 中的游标对象与变量绑定的详细内容，更多请关注php中文网其它相关文章！
python怎么学习？python怎么入门？python在哪学？python怎么学才快？不用担心，这里为大家提供了python速学教程(入门到精通)，有需要的小伙伴保存下载就能学习啦！
广告Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号
969
收藏
