apilevel

DBAPI级别，当前为2.0

pyzenith.apilevel

threadsafety

接口的线程安全级别，当前为2

pyzenith.threadsafety

paramstyle

参数格式类型，当前为pyformat

pyzenith.paramstyle

host

string型变量，指定数据库服务端所在IP地址。

按照args或kwargs形式使用此变量。

user

string型变量，指定连接数据库的用户名。

passwd

string型变量，指定登录数据库用户的密码。

port

string型变量，指定数据库服务端侦听端口。

ssl_ca

string型变量，SSL的ca文件，如果服务端要求使用ssl连接则需要设置该参数。

ssl_cert

string型变量，SSL的client-cert文件，如果服务端要求使用ssl连接则需要设置该参数。

ssl_key

string型变量，SSL的client-key文件，如果服务端要求使用ssl连接则需要设置该参数。

ssl_crl

string型变量，SSL的crl文件，如果没有可以为空

ssl_keypwd

string型变量，生成SSL时的密码，如果没有设置可以为空

ssl_mode

string型变量，有4中模式:

D (禁用SSL连接)

P (优先使用SSL连接，如果服务端不支持SSL也可连接成功，默认值)

R (必须使用SSL连接，如果服务端不支持SSL，会导致连接建立失败)

V (校验服务端证书信息)

logintimeout

int型变量，设置连接超时时间，单位为秒，不设置是为系统默认值10s

-

sockettimeout

int型变量，设置socket超时时间，单位为秒，不设置是为系统默认值600s

-

__init__(self, *args, **kwargs)

Connection类初始化时调用的方法，发起与数据库的连接。

-

是

autocommit(self, isautocommit)

设置事务是否自动提交。Isautocommit为bool类型

conn.autocommit(True)

是

cursor(self)

返回Cursor类对象。

cursor = conn.cursor()

是

commit(self)

提交事务，当事务设置为手动提交时可调用。

conn.commit()

是

rollback(self)

回滚事务。

conn.rollback()

是

close(self)

关闭数据库连接。

conn.close()

是

description

获取查询语句的列描述。

cursor.description

是

rowcount

获取操作产生的行数（dml影响的行数，select语句返回值为0）。

cursor.rowcount

是

lastrowid

返回当前会话最后一次INSERT语句AUTO_INCREMENT列自动生成的值。

cursor.lastrowid

是

close(self)

关闭cursor对象。

cursor.close()

否

execute(self, sql[,parameters])

• 执行SQL语句，sql参数为sql语句字符串。

• parameters可选，有parameters时，功能和executemany一样（目前绑定参数不支持select）。

cursor.execute(“select * from table”)

cursor.execute("insert into tb_1 values (:1)",[('1',),])

是

executemany(self,sql,parameters)

• 执行批量绑定的SQL语句（目前不支持select）。

• 参数必须是tuple组成的list，tuple必须是字符串。

• 绑定最大列为512，最大行数1024。

cursor.executemany("insert into tb_1 values (:1)",[('1',),])

是

fetchall(self)

获取结果集中的所有元组。

cursor.fetchall()

是

fetchone(self)

获取结果集中的下一个元组。

cursor.fetchone()

是

fetchmany(size)

获取结果集中接下来的size个元组。

cursor.fetchmany()

是

execute_ex(self,sql[,parameters])

• 执行SQL语句，sql参数为sql语句字符串。

• parameters可选，有parameters时，功能和executemany_ex相同（目前绑定参数不支持select）。

cursor.execute_ex(“select * from table”)

cursor.execute_ex("insert into tb_1 values (:1)",[('1',),])

是

executemany_ex(self,sql,parameters)

• 执行批量绑定的SQL语句（目前不支持select）。

• 参数必须是tuple组成的list，tuple可以为字符串或者python数据类型。

• 绑定最大列为512，最大行数1024。

cursor.executemany_ex("insert into tb_1 values (:1)",[('1',),])

是

fetchall_ex(self)

获取结果集中的所有元组，时间，数值和布尔类型的返回类型为python数据类型，其他类型返回字符串数据类型。

cursor.fetchall_ex()

是

fetchone_ex(self)

获取结果集中的下一个元组，时间，数值和布尔类型的返回类型为python数据类型，其他类型返回字符串数据类型。

cursor.fetchone_ex()

是

fetchmany_ex(size)

获取结果集中接下来的size个元组，时间，数值和布尔类型的返回类型为python数据类型，其他类型返回字符串数据类型。

cursor.fetchmany_ex()

是

Date(year,month,day)

构造包含日期的对象

pyzenith.Date(2018,2,29)

否

Time(hour,minute,second)

构造包含时间的对象

pyzenith.Time(-1, 0, 0)

否

Timestamp(year,month,day,hour,minute,second,usec)

构造包含时间戳的对象

pyzenith.Timestamp(2018,1,1,1,1,1,12342)

否

DateFromTicks(ticks)

构造给定ticks值的日期值

pyzenith.DateFromTicks(1234567890)

否

TimeFromTicks(ticks)

构造给定ticks值的时间值

pyzenith.TimeFromTicks(1234567890)

否

TimestampFromTicks(ticks)

构造给定ticks值的时间戳值

pyzenith.TimestampFromTicks(1234567890)

否