文档首页/ 云数据库 GaussDB/ 开发指南（分布式_3.x）/ 应用程序开发教程/ 基于libpq开发/ libpq接口参考/ 数据库连接控制函数/ PQconnectdbParams
更新时间：2024-05-07 GMT+08:00
查看PDF
分享

PQconnectdbParams

功能描述

与数据库服务器建立一个新的连接。

原型

1
 
PGconn* PQconnectdbParams(const char* const* keywords, const char* const* values, int expand_dbname);

参数

表1 PQconnectdbParams参数

关键字

参数说明

keywords

定义为一个字符串的数组，每个都成为一个关键字。

values

给每个关键字一个值。

expand_dbname

当expand_dbname非零时，允许将dbname的关键字值看做一个连接字符串。只有第一个出现的dbname是这样展开的，随后的dbname值作为纯数据库名处理。

返回值

PGconn *：指向包含连接的对象指针，内存在函数内部申请。

注意事项

这个函数用从两个NULL结束的数组中的参数打开一个新的数据库连接。与PQsetdbLogin不同的是，该函数可以不必更换函数签名（名字）就可以扩展参数集，所以建议应用程序中使用该函数（或者类似的非阻塞变种PQconnectStartParams和PQconnectPoll）。