附录1:主要接口
psycopg2模块提供建立和管理与Vastbase G100 数据库连接、执行SQL 语句和对结果集进行储存管理的若干接口。主要接口说明如下:
psycopg2.connect()
此方法用于创建新的数据库会话并返回新的connection对象。参数说明如下:
关键字 | 参数说明 |
---|---|
dbname | 数据库名称 |
user | 用户名 |
password | 密码 |
host | 数据库所在主机IP地址 |
port | 连接端口号,默认为5432 |
sslmode | ssl模式,ssl连接时用 |
sslcert | 客户端证书路径,ssl连接时用 |
sslkey | 客户端秘钥路径,ssl连接时用 |
sslrootcert | 根证书路径,ssl连接时用 |
返回值:connection对象(连接Vastbase G100数据库实例的对象)。
调用示例见附录2。
connection.cursor()
此方法用于返回新的cursor对象。参数说明如下:
关键字 | 参数说明 |
---|---|
name | cursor名称,默认为None |
cursor_factory | 用于创造非标准cursor,默认为None |
scrollable | 设置SCROLL选项,默认为None |
withhold | 设置HOLD选项,默认为False |
返回值为cursor对象(用于整个数据库使用Python编程的cursor)。
调用示例见附录2。
cursor.execute()
此方法执行被参数化的SQL语句(即占位符,而不是SQL文字)。psycopg2模块支持用%s标志的占位符。参数说明如下:
关键字 | 参数说明 |
---|---|
query | 待执行的sql语句 |
vars_list | 变量列表,匹配query中%s为占位符 |
返回值:无。
调用示例见附录2。
connection.commit()
此方法将当前挂起的事务提交到数据库。默认情况下,psycopg2在执行第一个命令之前打开一个事务:如果不调用commit(),任何数据操作的效果都将丢失。
参数:无。
返回值:无。
调用示例见附录2。
connection.rollback()
此方法回滚当前挂起事务。
参数:无。
返回值:无
调用示例见附录2。
cursor.fetchone()
此方法提取查询结果集的下一行,并返回一个元组。
参数:无。
返回值:单个元组,为结果集的第一条结果,当没有更多数据可用时,返回为“None”。
调用示例见附录2。
cursor.fetchall()
此方法获取查询结果的所有(剩余)行,并将它们作为元组列表返回。
参数:无。
返回值:元组列表,为结果集的所有结果。空行时则返回空列表。
调用示例见附录2。
cursor.close()
此方法用于关闭当前连接的游标。
参数:无。
返回值:无。
调用示例见附录2。
connection.close()
此方法用于关闭数据库连接。
参数:无。
返回值:无。
调用示例见附录2。