VastbaseG100

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

Menu

PQexec

功能描述

给服务器提交一条命令并且等待结果。

接口原型

PGresult *PQexec(PGconn *conn, const char *query);

参数说明

参数名 参数说明
conn 建立连接时返回的连接结构体指针,该指针用于标识某个特定连接。
query 命令字符串,可以包括多个SQL命令(用分号分隔)。

返回值

返回一个PGresult指针或者空指针。 通常返回非空指针,除非耗尽内存或发生了像不能把命令发送到服务器这样的严重错误。 应该调用PQresultStatus函数来检查任何错误的返回值 (包括空指针的值,在这种情况下它将返回PGRES_FATAL_ERROR)。 使用PQerrorMessage获取有关错误的更多信息。

其他

命令字符串可以包括多个SQL命令(用分号分隔)。在一个PQexec 调用中发送的多个查询是在一个事务里处理的,除非在查询字符串里有明确的 BEGIN/COMMIT命令把整个字符串分隔成多个事务。

请注意,返回的PGresult结构只描述字符串里执行的最后一条命令的结果。 如果有一个命令失败,那么字符串处理的过程就会停止,并且返回的PGresult 会描述错误条件。