read
port
此属性用来获取连接参数中定义的主机端口号。
表6-6 port 属性
类型
值
默认值
可读写
int
有效的端口号
5258
read
database
此属性用来设置获取连接参数中定义的数据库。
表6-7 database 属性
类型
值
默认值
可读写
string
非空字符串
‘’
read/write
autocommit
此属性用来设置获取自动提交模式,此模式在支持事务的产品中有效。为True 时,
自动提交模式开启,
执行任何DML 语句时数据的更改立刻生效。
为False 时,
自动
提交模式关闭,受影响数据不会立刻生效。
表6-8 autocommit 属性
GBase UP 产品手册 6 应用开发指南
文档版本04(2021-04-21) 南大通用数据技术股份有限公司 1289
类型
值
默认值
可读写
bool
True / False
True
read/write
方法
GBaseConnection
GBaseConnection 类构造函数。
表6-9 GBaseConnection 属性
函数名称
返回值
返回值类型
函数参数
参数含义
GBaseConnection
instance
GBaseConnection
**kwargs
(dict)
连接参数,以字典方
式传入构造函数。如
下示例:
config =
{
'host':
'172.16.31.10',
'user': 'gbase',
'port': 5258,
'database': 'test' }
样例代码
code
from GBaseConnector import connect
config = {'host' : '172.16.3.10',
'port' : 5258,
'user' : 'gbase',
'password' : 'gbase20110531',
'database' : 'test'}
conn = GBaseConnection(**config)
# 使用下面的方法初始化连接,也返回GBaseConnection 对象
conn = connect(**config)
close
关闭连接方法。此方法调用后,当前GBaseConnection 对象与GBase Server 的连接
断开。
表6-10 close 属性
函数名称
返回值
返回值类型
函数参数
参数含义
GBase UP 产品手册 6 应用开发指南
文档版本04(2021-04-21) 南大通用数据技术股份有限公司 1290
close
无
无
无
无
样例代码
code
from GBaseConnector import connect
config = {'host' : '172.16.3.10',
'port' : 5258,
'user' : 'gbase',
'password' : 'gbase20110531',
'database' : 'test'}
conn = connect(**config)
conn.close()
connect
实现与GBase Server 建立通讯连接。此方法如果不单独调用,则默认在
GBaseConnection 构造函数中调用。
表6-11 connect 属性
函数名称
返回值
返回值类型
函数参数
参数含义
connect
无
无
**kwargs
(dict)
连接参数,
以字典方
式传入构造函数。
如
下示例:
config = { 'host':
'172.16.31.10',
'user': 'gbase',
'port': 5258,
'database':
'test' }
样例代码
code
from GBaseConnector import connect
config = {'host' : '172.16.3.10',
'port' : 5258,
'user' : 'gbase',
'password' : 'gbase20110531',
'database' : 'test'}
conn = GBaseConnection()
GBase UP 产品手册 6 应用开发指南
文档版本04(2021-04-21) 南大通用数据技术股份有限公司 1291
conn.connect(**config)
conn.close()
commit
实现事务提交功能,与事务回滚rollback 方法对应。当连接事务开启后(连接参数
autocommit 配置为false),并且已经执行了DML 语句,如:insert into [table]
values(‘value1’)。需要调用此方法提交事务,已使DML 语句生效。
表6-12 commit 属性
函数名称
返回值
返回值类型
函数参数
参数含义
commit
无
无
无
无
样例代码
code
from GBaseConnector import connect
config = {'host' : '172.16.3.10',
'port' : 5258,
'user' : 'gbase',
'password' : 'gbase20110531',
'database' : 'test',
'autocommit': False}
conn = connect(**config)
cur = conn.cursor()
cur.execute("insert into test values(1,'aaa')")
conn.commit()
conn.close()
cursor
此方法返回与GBaseConnection 对象关联的游标对象,游标对象可用来执行
DML/DDL 语句、获取结果集、执行存储过程等。
表6-13 cursor 属性
函数名称
返回值
返回值类型
函数参数
参数含义
cursor
无
无
无
无
样例代码
code
GBase UP 产品手册 6 应用开发指南
文档版本04(2021-04-21) 南大通用数据技术股份有限公司 1292
from GBaseConnector import connect
config = {'host' : '172.16.3.10',
'port' : 5258,
'user' : 'gbase',
'password' : 'gbase20110531',
'database' : 'test'}
conn = connect(**config)
cur = conn.cursor()
cur.execute("insert into test values(1,'aaa')")
conn.close()
rollback
实现事务回滚功能,与事务提交commit 方法对应。当连接事务开启后(连接参数
autocommit 配置为false),并且已经执行了DML 语句,如:insert into [table]
values(‘value1’)。调用此方法可回滚事务,取消DML 语句。
表6-14 cursor 属性
函数名称
返回值
返回值类型
函数参数
参数含义
rollback
无
无
无
无
样例代码
code
from GBaseConnector import connect
config = {'host' : '172.16.3.10',
'port' : 5258,
'user' : 'gbase',
'password' : 'gbase20110531',
'database' : 'test',
'autocommit': False}
conn = connect(**config)
cur = conn.cursor()
cur.execute("insert into test values(1,'aaa')")
conn.rollback()
conn.close()