`python-oracledb` 的 `cursor.var()` 方法用于创建客户端绑定变量。这些变量是 Python 对象，其值在客户端内存中维护，并不会因数据库连接的关闭而自动丢失。只有当变量通过游标执行 SQL 语句时，其值才与数据库会话进行交互。理解这一客户端与服务器端的区别，对于正确管理数据持久性和连接至关重要。
1. python-oracledb 游标与绑定变量概述
在使用 python-oracledb 与 Oracle 数据库交互时，cursor 对象扮演着核心角色，它是执行 SQL 语句、管理事务以及获取查询结果的接口。cursor.var() 方法则用于创建绑定变量，这些变量在 SQL 语句中作为占位符，可以动态地传递数据到数据库或从数据库接收数据。
绑定变量的主要优势包括：
- 安全性： 有效防止 SQL 注入攻击。
- 性能： 允许数据库重用执行计划，减少解析开销。
- 类型安全： 明确指定数据类型，避免潜在的类型转换问题。
2. 连接、会话与游标的生命周期
理解 python-oracledb 中对象的工作原理，首先需要明确数据库连接、会话和游标的生命周期：
立即学习“Python免费学习笔记（深入）”；
- 数据库连接 (oracledb.Connection)： 当调用 oracledb.connect() 时，客户端应用程序与 Oracle 数据库建立了一个网络连接。
- 数据库会话 (Session)： 成功建立连接后，Oracle 数据库会为该连接创建一个用户会话。这个会话是用户与数据库交互的上下文，它包含了用户的权限、当前事务状态以及所有与该会话相关的资源（如打开的游标、临时表等）。
- 游标 (oracledb.Cursor)： 通过 connection.cursor() 创建的游标对象是特定于其父连接所代表的数据库会话的。它用于在该会话中执行 SQL 语句。
关键点： 当您调用 connection.close() 时，不仅会关闭客户端与数据库的网络连接，还会终止服务器上的相应数据库会话。这意味着与该会话关联的所有服务器端资源（包括数据库内部的游标状态、PL/SQL 包变量等）都会被释放。每次重新调用 oracledb.connect() 都会建立一个全新的连接，并创建一个全新的、独立的数据库会话。
3. cursor.var() 创建的变量的客户端性质
cursor.var() 方法返回的是一个 oracledb.Var 类型的 Python 对象。这个对象存在于您的 Python 应用程序的内存中，而不是数据库服务器的内存中。
- 当您调用 host_variable.setvalue(0, 'VALUE') 时，您修改的是这个客户端 Python 对象内部存储的值。
- 这个值只有在您通过游标执行包含该绑定变量的 SQL 语句时，才会被发送到数据库服务器。同样，如果绑定变量用于接收数据库返回的数据，数据也会从服务器传输到这个客户端 Python 对象。
因此，即使您关闭了数据库连接（从而终止了数据库会话），只要持有 oracledb.Var 对象的 Python 变量仍然在作用域内并且没有被重新赋值，它在客户端内存中的值就会继续存在。这解释了为什么在重新连接后，您仍然可以访问之前设置的值。您访问的仅仅是客户端 Python 对象的状态，而不是数据库服务器上任何持久化的会话状态。
4. 示例分析：理解变量的客户端生命周期
让我们通过一个修正后的示例来清晰地展示这一点。原始问题中的代码之所以看似“维持”了值，是因为它重复使用了同一个 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 已关闭。")分析上述代码：
- host_variable1 在 con1.close() 后仍然保留了其值 VALUE_FROM_SESSION_1，因为它是一个独立的 Python 对象。
- host_variable2 是一个全新的 oracledb.Var 对象，它没有继承 host_variable1 的值。这证明了数据库会话的关闭不会影响客户端 Python 变量的值，并且新的会话也不会自动“继承”旧会话的绑定变量。
5. 如何实现跨会话的数据持久性
如果您确实需要在不同的数据库连接/会话之间维护数据，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]}")
6. 总结与最佳实践
- 区分客户端与服务器端： python-oracledb 的 cursor.var() 创建的变量是客户端 Python 对象，其值在客户端内存中维护。数据库连接的关闭只会终止服务器端的会话资源，不会自动清除客户端 Python 变量的值。
- 理解会话生命周期： 每次建立新的数据库连接都会创建一个新的独立会话。会话间的状态（如游标、PL/SQL 包变量）默认不共享。
-
明确数据持久化需求：
- 对于应用程序内部、短期的状态，使用 Python 变量即可。
- 对于需要跨会话或跨应用程序实例的长期持久化，务必将数据存储到数据库表中。
- 规范连接管理： 始终使用 with 语句来管理数据库连接和游标，确保它们在不再需要时被正确关闭和释放资源，即使发生异常。
通过深入理解这些基本概念，您可以更有效地使用 python-oracledb 进行开发，并避免因对底层机制的误解而导致的问题。
