Python接口参考
全局变量
参数名 |
参数说明 |
使用方法 |
---|---|---|
apilevel |
DBAPI级别,当前为2.0 |
pyzenith.apilevel |
threadsafety |
接口的线程安全级别,当前为2 |
pyzenith.threadsafety |
paramstyle |
参数格式类型,当前为pyformat |
pyzenith.paramstyle |
Connect方法
参数名称 |
参数说明 |
使用方法 |
---|---|---|
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 |
- |
Connection类
方法名称 |
方法说明 |
使用案例 |
是否线程安全 |
---|---|---|---|
__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() |
是 |
Cursor类
属性名称 |
属性说明 |
使用案例 |
是否线程安全 |
---|---|---|---|
description |
获取查询语句的列描述。 |
cursor.description |
是 |
rowcount |
获取操作产生的行数(dml影响的行数,select语句返回值为0)。 |
cursor.rowcount |
是 |
lastrowid |
返回当前会话最后一次INSERT语句AUTO_INCREMENT列自动生成的值。 |
cursor.lastrowid |
是 |
方法名称 |
方法说明 |
使用案例 |
是否线程安全 |
---|---|---|---|
close(self) |
关闭cursor对象。 |
cursor.close() |
否 |
execute(self, sql[,parameters]) |
|
cursor.execute(“select * from table”) cursor.execute("insert into tb_1 values (:1)",[('1',),]) |
是 |
executemany(self,sql,parameters) |
|
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]) |
|
cursor.execute_ex(“select * from table”) cursor.execute_ex("insert into tb_1 values (:1)",[('1',),]) |
是 |
executemany_ex(self,sql,parameters) |
|
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) |
否 |