VastbaseG100

基于openGauss内核开发的企业级关系型数据库。

Menu

附录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。