|
|
相关文章推荐
Main Functions
PQexec
PGresult *PQexec(PGconn *conn, const char *command)
向服务器提交命令并等待结果。返回一个 PGresult 指针或者可能是一个空指针。 除非内存不足或严重错误（例如无法将命令发送到服务器），否则通常会返回非空指针。 应该调用 PQresultStatus 函数来检查任何错误的返回值（包括空指针的值，在这种情况下它将返回 PGRES_FATAL_ERROR）。 使用 PQerrorMessage 获取有关此类错误的更多信息。
PGresult *PQexec(PGconn *conn, const char *query) { if (!PQexecStart(conn)) return NULL; if (!PQsendQuery(conn, query)) return NULL; return PQexecFinish(conn);PQexec函数主要用于普通同步应用中提交命令，它的缺点如下所示：
- PQexec会等待命令执行完成，也就是阻塞等待回应。可能应用程序并不能接受这种同步风格的API。
- 由于上面的原因客户端应用的执行在等待PQexec结果时会被挂起，对应应用程序来说难以决定是否需要取消正在执行的命令（这可以在信号处理器中完成，也就只有这种办法）
- PQexec只能返回PGresult结果结构。如果提交的命令包含多个SQL，除了最后一个PGresult，其他的结果都会被PQexec丢弃。
- PQexec总是收集命令的整个结果，将其缓存在PGresult中，虽然简化了错误处理逻辑，但是如果结果集过大，可能这种处理逻辑就不太合适
可以改用PQexec的底层函数PQsendQuery、PQsendQueryParams、PQgetResult、PQsendPrepare、PQsendQueryPrepared、PQsendDescribePrepared以及PQsendDescribePortal等改写执行逻辑。
PQexecParams
向服务器提交命令并等待结果，能够将参数与 SQL 命令文本分开传递。PQexecParams 类似于 PQexec，但提供了额外的功能：参数值可以与命令字符串分开指定，并且可以以文本或二进制格式请求查询结果。PQexecParams 优于 PQexec 的主要优点是参数值可以从命令字符串中分离出来，从而避免了繁琐且容易出错的引用和转义。与 PQexec 不同，PQexecParams 在给定字符串中最多允许一个 SQL 命令。 （其中可以有分号，但不能超过一个非空命令。）这是底层协议的一个限制，但作为对 SQL 注入攻击的额外防御有一些用处。
通过 OID 指定参数类型是乏味的，特别是如果您不想将特定的 OID 值硬连接到您的程序中。 但是，即使服务器本身无法确定参数的类型，或者选择的类型与您想要的不同，您也可以避免这样做。 在 SQL 命令文本中，将显式转换附加到参数符号以显示您将发送的数据类型。 例如：Specifying parameter types via OIDs is tedious, particularly if you prefer not to hard-wire particular OID values into your program. However, you can avoid doing so even in cases where the server by itself cannot determine the type of the parameter, or chooses a different type than you want. In the SQL command text, attach an explicit cast to the parameter symbol to show what data type you will send. For example:
SELECT * FROM mytable WHERE x = $1::bigint;
这会强制参数 $1 被视为 bigint，而默认情况下它将被分配与 x 相同的类型。 在以二进制格式发送参数值时，强烈建议以这种方式或通过指定数字类型 OID 强制参数类型决策，因为二进制格式的冗余比文本格式少，因此服务器检测到类型的机会较小 不匹配错误给你。This forces parameter $1 to be treated as bigint, whereas by default it would be assigned the same type as x. Forcing the parameter type decision, either this way or by specifying a numeric type OID, is strongly recommended when sending parameter values in binary format, because binary format has less redundancy than text format and so there is less chance that the server will detect a type mismatch mistake for you.PQprepare
提交使用给定参数创建准备好的语句的请求，并等待完成。Submits a request to create a prepared statement with the given parameters, and waits for completion.
PGresult *PQprepare(PGconn *conn, const char *stmtName, const char *query, int nParams, const Oid *paramTypes);PQprepare 创建一个准备好的语句，供以后使用 PQexecPrepared 执行。该特性允许命令重复执行，无需每次都进行解析和规划；有关详细信息，请参阅准备。PQprepare creates a prepared statement for later execution with PQexecPrepared. This feature allows commands to be executed repeatedly without being parsed and planned each time; see PREPARE for details.
该函数根据查询字符串创建一个名为 stmtName 的预准备语句，该语句必须包含一个 SQL 命令。 stmtName 可以是 “” 来创建一个未命名的语句，在这种情况下，任何预先存在的未命名语句都会被自动替换；否则，如果当前会话中已经定义了语句名称，则会出错。如果使用任何参数，它们在查询中称为 $1、$2 等。nParams 是在数组 paramTypes[] 中预先指定类型的参数的数量。 （当 nParams 为零时，数组指针可以为 NULL。） paramTypes[] 通过 OID 指定要分配给参数符号的数据类型。如果 paramTypes 为 NULL，或者数组中的任何特定元素为零，则服务器将数据类型分配给参数符号，就像它为无类型文字字符串所做的那样。此外，查询可以使用数字大于 nParams 的参数符号；还将为这些符号推断数据类型。 （请参阅 PQdescribePrepared 了解推断出哪些数据类型的方法。）The function creates a prepared statement named stmtName from the query string, which must contain a single SQL command. stmtName can be “” to create an unnamed statement, in which case any pre-existing unnamed statement is automatically replaced; otherwise it is an error if the statement name is already defined in the current session. If any parameters are used, they are referred to in the query as $1, $2, etc. nParams is the number of parameters for which types are pre-specified in the array paramTypes[]. (The array pointer can be NULL when nParams is zero.) paramTypes[] specifies, by OID, the data types to be assigned to the parameter symbols. If paramTypes is NULL, or any particular element in the array is zero, the server assigns a data type to the parameter symbol in the same way it would do for an untyped literal string. Also, the query can use parameter symbols with numbers higher than nParams; data types will be inferred for these symbols as well. (See PQdescribePrepared for a means to find out what data types were inferred.)
与 PQexec 一样，结果通常是一个 PGresult 对象，其内容指示服务器端成功或失败。空结果表示内存不足或根本无法发送命令。使用 PQerrorMessage 获取有关此类错误的更多信息。As with PQexec, the result is normally a PGresult object whose contents indicate server-side success or failure. A null result indicates out-of-memory or inability to send the command at all. Use PQerrorMessage to get more information about such errors.
也可以通过执行 SQL PREPARE 语句来创建用于 PQexecPrepared 的预处理语句。此外，虽然没有用于删除准备好的语句的 libpq 函数，但 SQL DEALLOCATE 语句可用于此目的。Prepared statements for use with PQexecPrepared can also be created by executing SQL PREPARE statements. Also, although there is no libpq function for deleting a prepared statement, the SQL DEALLOCATE statement can be used for that purpose.
PQexecPrepared
发送请求以执行具有给定参数的准备好的语句，并等待结果。Sends a request to execute a prepared statement with given parameters, and waits for the result.
PGresult *PQexecPrepared(PGconn *conn, const char *stmtName, int nParams, const char * const *paramValues, const int *paramLengths, const int *paramFormats, int resultFormat);PQexecPrepared 类似于 PQexecParams，但要执行的命令是通过命名先前准备好的语句来指定的，而不是给出查询字符串。 此功能允许将重复使用的命令仅解析和计划一次，而不是每次执行。 该声明必须在当前会话中事先准备好。PQexecPrepared is like PQexecParams, but the command to be executed is specified by naming a previously-prepared statement, instead of giving a query string. This feature allows commands that will be used repeatedly to be parsed and planned just once, rather than each time they are executed. The statement must have been prepared previously in the current session.
参数与 PQexecParams 相同，只是给出了预准备语句的名称而不是查询字符串，并且 paramTypes[] 参数不存在（不需要，因为预准备语句的参数类型在创建时确定） .The parameters are identical to PQexecParams, except that the name of a prepared statement is given instead of a query string, and the paramTypes[] parameter is not present (it is not needed since the prepared statement’s parameter types were determined when it was created).
PQdescribePrepared
提交请求以获取有关指定准备好的语句的信息，并等待完成。Submits a request to obtain information about the specified prepared statement, and waits for completion.
PGresult *PQdescribePrepared(PGconn *conn, const char *stmtName);PQdescribePrepared 允许应用程序获取有关先前准备好的语句的信息。PQdescribePrepared allows an application to obtain information about a previously prepared statement.
stmtName 可以是 “” 或 NULL 以引用未命名的语句，否则它必须是现有预准备语句的名称。 成功时，返回状态为 PGRES_COMMAND_OK 的 PGresult。 函数 PQnparams 和 PQparamtype 可以应用于此 PGresult 以获取有关准备好的语句的参数的信息，而函数 PQnfields、PQfname、PQftype 等提供有关语句的结果列（如果有）的信息。stmtName can be “” or NULL to reference the unnamed statement, otherwise it must be the name of an existing prepared statement. On success, a PGresult with status PGRES_COMMAND_OK is returned. The functions PQnparams and PQparamtype can be applied to this PGresult to obtain information about the parameters of the prepared statement, and the functions PQnfields, PQfname, PQftype, etc provide information about the result columns (if any) of the statement.
PQdescribePortal
提交请求以获取有关指定门户的信息，并等待完成。Submits a request to obtain information about the specified portal, and waits for completion.
PGresult *PQdescribePortal(PGconn *conn, const char *portalName);PQdescribePortal 允许应用程序获取有关先前创建的门户的信息。 （libpq 不提供对门户的任何直接访问，但您可以使用此功能检查使用 DECLARE CURSOR SQL 命令创建的游标的属性。）PQdescribePortal allows an application to obtain information about a previously created portal. (libpq does not provide any direct access to portals, but you can use this function to inspect the properties of a cursor created with a DECLARE CURSOR SQL command.)
portalName 可以是 “” 或 NULL 以引用未命名的门户，否则它必须是现有门户的名称。 成功时，返回状态为 PGRES_COMMAND_OK 的 PGresult。 PQnfields、PQfname、PQftype 等函数可应用于 PGresult 以获取有关门户的结果列（如果有）的信息。portalName can be “” or NULL to reference the unnamed portal, otherwise it must be the name of an existing portal. On success, a PGresult with status PGRES_COMMAND_OK is returned. The functions PQnfields, PQfname, PQftype, etc can be applied to the PGresult to obtain information about the result columns (if any) of the portal.
PGresult 结构封装了服务器返回的结果。 libpq 应用程序程序员应该小心维护 PGresult 抽象。 使用下面的访问器函数来获取 PGresult 的内容。 避免直接引用 PGresult 结构的字段，因为它们将来可能会发生变化。The PGresult structure encapsulates the result returned by the server. libpq application programmers should be careful to maintain the PGresult abstraction. Use the accessor functions below to get at the contents of PGresult. Avoid directly referencing the fields of the PGresult structure because they are subject to change in the future.
Retrieving Query Result Information
Retrieving Other Result Information
Escaping Strings for Inclusion in SQL Commands
Main FunctionsPGresult *PQexec(PGconn *conn, const char *command)向服务器提交命令并等待结果。返回一个 PGresult 指针或者可能是一个空指针。 除非内存不足或严重错误（例如无法将命令发送到服务器），否则通常会返回非空指针。 应该调用 PQresultStatus 函数来检查任何错误的返回值（包括空指针的值，在这种情况下它将返回 PGRES_FATAL_ERROR）。 使用 PQerrorMessage 获取有关此类错误的更多信息。PGlibpq中的命令执行函数有：PQexec,PQexecParams,PQprepare,PQprepared。PQexec给服务器提交一条命令并且等待结果定义：PGresult *PQexec(PGconn *conn,const char *command);PQexec返回一个PGresult指针或者NULL。PGresult *res; const char *co...一、数据库连接控制函数 下面的函数处理与PostgreSQL服务器联接的事情。 一个应用程序一次可以与多个服务器建立联接。 （这么做的原因之一是访问多于一个数据库。） 每个连接都是用一个从函数PQconnectdb、PQconnectdbParams或PQsetdbLogin获得的PGconn对象表示。 注意，这些函数总是返回一个非空的对象指针，除非存储器少得连个PGconn对象都分配不出来。在把查询发送给连接对象之前， 可以调用PQstatus函数来检查一下返回值看看连接是否成功。文章目录1. 什么是libpq1.1 libpq位置2. 如何使用 1. 什么是libpq libpq是一组C编写的PostgreSQL客户端API（即库函数），允许客户端程序将查询传递给PostgreSQL后端（postgres）服务器，并接收这些查询的结果。此外，它也是其它几个PostgreSQL应用程序接口的底层引擎，包括C++、Perl、Python、Tcl和ECPG编写的那些。 1.1 libpq位置 libpq函数库位于src/interfaces/libpq目录下，位于github上面的 此位1.1 数据库连接控制函数 应用程序在连接数据库时必须使用本节介绍的数据库连接控制函数。应用程序可以同时建立多个数据库连接，一个连接只能访问一个数据库中的数据。每个数据库连接用一个PGconn对象表示，函数PQconnectdb 或PQsetdbLogin会返回一个上一期讲了一些如何通过jdbc连接postgresql数据库，这一期准备说一说如何通过libpq连接postgresql数据库。 上一期的jdbc是postgresql的java语言应用程序接口，这一期的libpq对应的是postgresql的C语言应用程序接口。 这里依旧分为三个模块来讲： 一.获取连接 二.执行select语句 三.执行insert，delete，update语句libpq是什么呢？英文原话是：libpq is the C application programmer’s interface to PostgreSQL，原来是postgresql的c语言应用程序接口，postgresql的官网是：http://www.postgresql.org/。 1. postgresql安装 在ubuntu下，使用下面的命令（12.04）来安装： CCH2024: [BACKEND] WARNING: could not fork new process for connection due to PMstate PM_WAIT_BACKENDS 日志里有这个错误，不知道该怎么处理了！！！ Golang入门之——文件锁操作flock 请问下，为啥显示syscall没有flock方法，1.21版本 linux 文件保护-使用chattr +i保护 csdn_clwjc: 请问博主有遇到过执行"chattr -i 文件名"却无法去除i属性的情况吗 Greenplum数据库数据分片策略Hash分布——计算哈希值和映射segment pirch@: 写的很好，很有收获。 Intel微处理器Uncore架构简介 Rob月初: 纠正一点：PCIe也有集成到Uncore，可以查看intel xeon系列处理器的架构。
推荐文章