python连接db2的官方库ibm_db的api

IBM_DB API 详细文档

ibm_db.active

​描述​
检查指定的数据库连接是否处于活动状态

​传入参数​

• connection: 有效的数据库连接资源

​返回值​

• True: 资源处于活动状态
• False: 资源未处于活动状态

​例子​

import ibm_db
conn = ibm_db.connect("DATABASE=testdb;HOSTNAME=localhost;PORT=50000;PROTOCOL=TCPIP;UID=dbuser;PWD=password;", "", "")
if ibm_db.active(conn):
    print("Connection is active")
else:
    print("Connection is inactive")
ibm_db.close(conn)

---

ibm_db.autocommit

​描述​
返回并设置指定数据库连接的自动提交行为

​传入参数​

• connection: 有效的IBM_DBConnection
• value(可选): 以下常量之一
  • ibm_db.SQL_AUTOCOMMIT_OFF
  • ibm_db.SQL_AUTOCOMMIT_ON

​返回值​

• 未传递值时：
  • 0: 自动提交功能关闭
  • 1: 自动提交功能打开
• 传递值时：
  • True: 自动提交功能已成功设置为值
  • False: 自动提交功能未成功设置为值

​例子​

# 获取当前自动提交状态
status = ibm_db.autocommit(conn)

# 设置自动提交为OFF
result = ibm_db.autocommit(conn, ibm_db.SQL_AUTOCOMMIT_OFF)
if result:
    print("Autocommit turned off successfully")

---

ibm_db.bind_param

​描述​
将Python变量绑定到SQL语句参数

​传入参数​

• stmt: 从ibm_db.prepare()返回的已准备好的语句
• parameter_number: 参数在准备语句中的1索引位置
• variable: Python变量，用于绑定到指定参数
• parameter_type(可选): 指定参数输入/输出类型的常量
  • ibm_db.SQL_PARAM_INPUT: 仅限输入的参数
  • ibm_db.SQL_PARAM_OUTPUT: 仅输出参数
  • ibm_db.SQL_PARAM_INPUT_OUTPUT: 输入输出参数
  • ibm_db.PARAM_FILE: 数据存储在文件中
• data_type(可选): 指定SQL数据类型的常量
  • ibm_db.SQL_BINARY
  • ibm_db.DB2_CHAR
  • ibm_db.DB2_DOUBLE
  • ibm_db.DB2_LONG
• precision(可选): 变量的精度
• scale(可选): 变量的小数位数

​返回值​

• True: 绑定成功
• None: 绑定失败

​例子​

stmt = ibm_db.prepare(conn, "INSERT INTO employees (id, name, salary) VALUES (?, ?, ?)")
id = 123
name = "John Doe"
salary = 75000.50

ibm_db.bind_param(stmt, 1, id, ibm_db.SQL_PARAM_INPUT)
ibm_db.bind_param(stmt, 2, name, ibm_db.SQL_PARAM_INPUT)
ibm_db.bind_param(stmt, 3, salary, ibm_db.SQL_PARAM_INPUT)
ibm_db.execute(stmt)

---

ibm_db.callproc

​描述​
调用存储过程

​传入参数​

• conn: 数据库连接
• proc_name: 存储过程名称
• parameters(可选): 输入参数列表

​返回值​

• True: 存储过程调用成功
• False: 调用失败

​例子​

# 调用无参存储过程
ibm_db.callproc(conn, "update_salaries")

# 调用带参存储过程
params = [1000, 10]
ibm_db.callproc(conn, "adjust_salaries", params)

---

ibm_db.client_info

​描述​
获取客户端信息

​传入参数​

• conn: 数据库连接

​返回值​

• 包含客户端信息的字典
  • DRIVER_NAME: 驱动名称
  • DRIVER_VER: 驱动版本
  • DATA_SOURCE_NAME: 数据源名称
  • DRIVER