文档首页> 云数据库 GaussDB> 主备版_8.x版本> 应用程序开发教程> 基于libpq开发> libpq接口参考> 数据库连接控制函数> PQconnectStart
更新时间：2024-06-03 GMT+08:00
查看PDF

PQconnectStart

功能描述

与数据库服务器建立一次非阻塞的连接。

原型

PGconn* PQconnectStart(const char* conninfo);

参数

表1

关键字

参数说明

conninfo

连接信息字符串。可以为空，这样将会使用默认参数。也可以包含由空格分隔的一个或多个参数设置，还可以包含一个URL。

返回值

PGconn类型指针。
  • 使用非阻塞方式（PQconnectStart + PQconnectPoll）连接数据库且连接信息中包含多个IP时，libpq会按顺序尝试连接每个IP并检查target_session_attrs，直到连接成功。
  • 使用非阻塞方式连接数据库时，超时检测需要通过上层应用来处理。