VastbaseG100

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

Menu

LibPQ库主要接口类型

Vastbase G100 libpq库由具有建立与Vastbase G100数据库连接、执行SQL语句和对结果集进行获取的若干类型接口组成。

数据库连接控制函数

这类函数会建立一个Vastbase G100后端服务器的连接。一个应用程序可以在一个时刻打开多个后端连接。每个连接用一个PGconn对象表示,它从函数PQconnectdb、PQconnectdbParams或PQsetdbLogin得到。简单列举相关函数: - PQconnectdbParams - PQconnectdb - PQsetdbLogin - PQsetdb - PQconnectStartParams(非阻塞) - PQconnectStart(非阻塞) - PQconnectPoll(非阻塞)

连接状态函数

当需要获取一个已有数据库连接对象的状态时,如获取连接的数据库名、用户名、主机名等信息,可以调用连接状态函数来获取,简单列举相关函数:

  • PQdb
  • PQuser
  • PQpass
  • PQhost
  • PQport

同步命令执行函数

与特定数据库的连接,在连接上下文中执行SQL 语句并返回结果。这些函数均为同步函数,需要等待命令完成才会返回。简单列举相关函数:

  • PQexec
  • PQexecParams
  • PQprepare
  • PQexecPrepared

异步命令执行函数

与特定数据库的连接,在连接上下文中执行SQL 语句并返回结果。这些函数均为异步函数,不等待结果立即返回。示例:

  • PQsendQuery
  • PQsendQueryParams
  • PQsendPrepare
  • PQsendQueryPrepared
  • PQsendDescribePrepared

获取查询结果函数

获取SQL语句产生的结果集。简单列举相关函数:

  • PQntuples
  • PQnfields
  • PQfname
  • PQfnumber

逐行获取查询结果函数

通常,libpq会收集一个SQL命令的整个结果并且把它作为单个PGresult返回给应用。这对于返回大量行的命令是行不通的。对于这类情况,应用可以使用PQsendQuery和PQgetResult的单行模式。在这种模式中,结果行以一次一行的方式被返回给应用。以此来获取SQL语句产生的结果集。要进入到单行模式,在一次成功的PQsendQuery(或者其他兄弟函数)调用后立即调用PQsetSingleRowMode。这种模式选择只对当前正在执行的查询有效。然后反复调用PQgetResult,直到它返回空。

取消查询函数

当需要请求取消一个仍在被服务器处理的命令时,可以采用此类函数。

  • PQgetCancel
  • PQfreeCancel
  • PQrequestCancel

控制函数

当需要对libpq行为中的各项细节进行控制时,可以调用此类函数。如获取客户端编码、设置客户端编码、设置错误消息的详细程度、跟踪客户端和服务端的通讯等。

  • PQclientEncoding
  • PQsetClientEncoding
  • PQsetErrorVerbosity
  • PQtrace