PQexec 会等待查询完成。应用可能有其他工作要做（例如维护一个用户界面），这种情况下它不会想要阻塞等待响应。

由于控制权埋在 PQexec 内部，前端很难在需要时决定尝试取消正在进行的查询。（这可以在信号处理器中完成，但别无他法。）

PQexec 只能返回一个 PGresult 结构。如果提交的查询串包含多条 SQL 命令，除了最后一个 PGresult 之外都会被 PQexec 丢弃。

PQsetnonblocking 设置连接的非阻塞状态。

int PQsetnonblocking(PGconn *conn, int arg)

arg 为 TRUE 时把连接置为非阻塞状态，arg 为 FALSE 时置为阻塞状态。成功返回 0，出错返回 -1。

在非阻塞状态下，对 PQputline、PQputnbytes、PQsendQuery 和 PQendcopy 的调用不会阻塞；如果需要再次调用，它们会返回错误。

当数据库连接被设置为非阻塞模式后又调用了 PQexec 时，它会临时把连接置为阻塞状态，直到该 PQexec 完成。

预计不久的将来，libpq 的更多部分将变得对 PQsetnonblocking 功能安全。

PQisnonblocking 返回数据库连接的阻塞状态。

int PQisnonblocking(const PGconn *conn)

连接设置为非阻塞模式时返回 TRUE，阻塞时返回 FALSE。

PQsendQuery 向 Postgres 提交一个查询而不等待结果。查询成功发出返回 TRUE，否则返回 FALSE（此时用 PQerrorMessage 获取失败的更多信息）。

int PQsendQuery(PGconn *conn,
                const char *query);

成功调用 PQsendQuery 后，调用一次或多次 PQgetResult 获取查询结果。在 PQgetResult 返回 NULL（表示查询已完成）之前，不得（在同一连接上）再次调用 PQsendQuery。

PQgetResult 等待先前一次 PQsendQuery 的下一个结果并将其返回。查询完成且不再有结果时返回 NULL。

PGresult *PQgetResult(PGconn *conn);

必须反复调用 PQgetResult 直到它返回 NULL，表示查询已完成。（如果在没有活跃查询时调用，PQgetResult 会立即返回 NULL。）对 PQgetResult 返回的每个非空结果，应使用前文所述的同一批 PGresult 访问函数处理。用完每个结果对象后别忘了用 PQclear 释放。注意，只有当查询处于活跃状态且必要的响应数据尚未被 PQconsumeInput 读取时，PQgetResult 才会阻塞。

PQconsumeInput 如果后端有可用的输入，消费它。

int PQconsumeInput(PGconn *conn);

PQconsumeInput 正常返回 1 表示"no error"（没有错误）；发生问题时返回 0（此时 PQerrorMessage 会被设置）。注意，返回结果并不说明是否实际读取了输入数据。调用 PQconsumeInput 后，应用可以检查 PQisBusy 和/或 PQnotifies，看它们的状态是否发生了变化。

即使应用尚未准备好处理结果或通知，也可以调用 PQconsumeInput。该例程会读取可用数据并保存到缓冲区中，从而使 select(2) 的可读就绪指示消失。因此应用可以用 PQconsumeInput 立即清除 select 的就绪条件，随后再从容地检查结果。

PQisBusy 如果查询仍在忙碌则返回 1，也就是说 PQgetResult 会阻塞等待输入。返回 0 表示可以放心调用 PQgetResult 而不会阻塞。

int PQisBusy(PGconn *conn);

PQisBusy 本身不会尝试从后端读取数据；因此必须先调用 PQconsumeInput，否则忙碌状态永远不会结束。

PQflush 尝试刷新排队发往后端的任何数据，成功（或发送队列为空）返回 0，因某种原因失败返回 EOF。

int PQflush(PGconn *conn);

在非阻塞连接上，调用 select 判断响应是否到达之前需要先调用 PQflush。返回 0 可确保没有已排队但尚未真正发送到后端的数据。只有使用了 PQsetnonblocking 的应用才需要这样做。

PQsocket 获取后端连接套接字的文件描述符号。有效的描述符将 >= 0；结果为 -1 表示当前没有打开的后端连接。

int PQsocket(const PGconn *conn);

应当用 PQsocket 获取后端套接字描述符，为执行 select(2) 做准备。这使使用阻塞连接的应用可以同时等待后端响应或其他条件。如果 select(2) 的结果表明可以从后端套接字读取数据，就应调用 PQconsumeInput 读取数据；随后即可用 PQisBusy、PQgetResult 和/或 PQnotifies 处理响应。

非阻塞连接（使用了 PQsetnonblocking 的连接）在 PQflush 返回 0、表明没有缓冲数据等待发往后端之前，不应使用 select。

PQrequestCancel 请求 Postgres 放弃对当前查询的处理。

int PQrequestCancel(PGconn *conn);

取消请求成功发出则返回 1，否则返回 0。（若为 0，PQerrorMessage 会说明原因。）但成功发出并不能保证请求会生效。无论 PQrequestCancel 的返回值如何，应用都必须继续用 PQgetResult 按正常顺序读取结果。如果取消生效，当前查询会提前终止并返回一个错误结果。如果取消失败（例如因为后端已完成该查询的处理），则根本不会有可见的结果。