-
返回值 ConnStatusType：连接状态的枚举，包括： 1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23 CONNECTION_STARTED
等待进行连接。
CONNECTION_MADE
连接成功；等待发送。
CONNECTION_AWAITING_RESPONSE
等待来自服务器的响应。
CONNECTION_AUTH_OK
已收到认证；等待后端启动结束。
CONNECTION_SSL_STARTUP
协商SSL加密。
CONNECTION_SETENV
协商环境驱动的参数设置。
CONNECTION_OK
连接正常。
CONNECTION_BAD
连接故障。
-
注意事项 状态可以是多个值之一。但是，在异步连接过程之外只能看到其中两个：CONNECTION_OK和CONNECTION_BAD。与数据库的良好连接状态为CONNECTION_OK，与数据库连接失败状态为CONNECTION_BAD。通常，“正常”状态将一直保持到PQfinish，但通信失败可能会导致状态过早变为CONNECTION_BAD。在这种情况下，应用程序可以尝试通过调用进行恢复PQreset。
-
参数 表1 PQsetdbLogin参数 关键字 参数说明 pghost 要连接的主机名，详见连接参数说明描述的host字段。 pgport 主机服务器的端口号，详见连接参数说明描述的port字段。 pgoptions 添加命令行选项以在运行时发送到服务器，详见连接参数说明描述的options字段。 pgtty 忽略（该选项声明服务器日志的输出方向）。 dbName 要连接的数据库名，详见连接参数说明描述的dbname字段。 login 要连接的用户名，详见连接参数说明描述的user字段。 pwd 如果服务器要求密码认证，所用的密码，详见连接参数说明描述的password字段。
-
补充解释 PQbackendPID函数返回值在
GaussDB 中表示后台线程的槽位ID (SlotID)，而并非后台线程的BackendPid。 由于存在上述差异，不建议按照PostgreSQL同名函数的语义执行。 若希望获取该连接的后台PID，可以通过执行系统函数pg_backend_pid获取。同时，依赖libpq的其他驱动程序的同名接口（如Python连接驱动psycopg2的get_backend_pid函数）也遵循上述规则。
-
返回值 ConnStatusType：连接状态的枚举，包括： 1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23 CONNECTION_STARTED
等待进行连接。
CONNECTION_MADE
连接成功；等待发送。
CONNECTION_AWAITING_RESPONSE
等待来自服务器的响应。
CONNECTION_AUTH_OK
已收到认证；等待后端启动结束。
CONNECTION_SSL_STARTUP
协商SSL加密。
CONNECTION_SETENV
协商环境驱动的参数设置。
CONNECTION_OK
连接正常。
CONNECTION_BAD
连接故障。
-
注意事项 状态可以是多个值之一。但是，在异步连接过程之外只能看到其中两个：CONNECTION_OK和CONNECTION_BAD。与数据库的良好连接状态为CONNECTION_OK，与数据库连接失败状态为CONNECTION_BAD。通常，“正常”状态将一直保持到PQfinish，但通信失败可能会导致状态过早变为CONNECTION_BAD。在这种情况下，应用程序可以尝试通过调用进行恢复PQreset。
-
参数 表1 PQsetdbLogin参数 关键字 参数说明 pghost 要连接的主机名，请参见连接参数说明描述的host字段。 pgport 主机服务器的端口号，请参见连接参数说明描述的port字段。 pgoptions 添加命令行选项以在运行时发送到服务器，请参见连接参数说明描述的options字段。 pgtty 忽略（该选项声明服务器日志的输出方向）。 dbName 要连接的数据库名，请参见连接参数说明描述的dbname字段。 login 要连接的用户名，请参见连接参数说明描述的user字段。 pwd 如果服务器要求密码认证，所用的密码，请参见连接参数说明描述的password字段。
-
参数 表1 PQsetdbLogin参数 关键字 参数说明 pghost 要连接的主机名，详见连接参数说明描述的host字段。 pgport 主机服务器的端口号，详见连接参数说明描述的port字段。 pgoptions 添加命令行选项以在运行时发送到服务器，详见连接参数说明描述的options字段。 pgtty 忽略（该选项声明服务器日志的输出方向） dbName 要连接的数据库名，详见连接参数说明描述的dbname字段。 login 要连接的用户名，详见连接参数说明描述的user字段。 pwd 如果服务器要求密码认证，所用的密码，详见连接参数说明描述的password字段。
-
返回值 ConnStatusType：连接状态的枚举，包括： 1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23 CONNECTION_STARTED
等待进行连接。
CONNECTION_MADE
连接成功；等待发送。
CONNECTION_AWAITING_RESPONSE
等待来自服务器的响应。
CONNECTION_AUTH_OK
已收到认证；等待后端启动结束。
CONNECTION_SSL_STARTUP
协商SSL加密。
CONNECTION_SETENV
协商环境驱动的参数设置。
CONNECTION_OK
连接正常。
CONNECTION_BAD
连接故障。
-
注意事项 状态可以是多个值之一。但是，在异步连接过程之外只能看到其中两个：CONNECTION_OK和CONNECTION_BAD。与数据库的良好连接状态为CONNECTION_OK，与数据库连接失败状态为CONNECTION_BAD。通常，“正常”状态将一直保持到PQfinish，但通信失败可能会导致状态过早变为CONNECTION_BAD。在这种情况下，应用程序可以尝试通过调用进行恢复PQreset。
-
补充解释 PQbackendPID函数返回值在GaussDB中表示后台线程的槽位ID (SlotID)，而并非后台线程的BackendPid。由于存在上述差异，不建议按照PostgreSQL同名函数的语义执行。若希望获取该连接的后台PID，可以通过执行系统函数pg_backend_pid获取。同时，依赖libpq的其他驱动程序的同名接口（如Python连接驱动psycopg2的get_backend_pid函数）也遵循上述规则。
-
参数 表1 PQsetdbLogin参数 关键字 参数说明 pghost 要连接的主机名，详见连接参数说明描述的host字段。 pgport 主机服务器的端口号，详见连接参数说明描述的port字段。 pgoptions 添加命令行选项以在运行时发送到服务器，详见连接参数说明描述的options字段。 pgtty 忽略（该选项声明服务器日志的输出方向）。 dbName 要连接的数据库名，详见连接参数说明描述的dbname字段。 login 要连接的用户名，详见连接参数说明描述的user字段。 pwd 如果服务器要求密码认证，所用的密码，详见连接参数说明描述的password字段。
-
注意事项 状态可以是多个值之一。但是，在异步连接过程之外只能看到其中两个：CONNECTION_OK和CONNECTION_BAD。与数据库的良好连接状态为CONNECTION_OK，与数据库连接失败状态为CONNECTION_BAD。通常，“正常”状态将一直保持到PQfinish，但通信失败可能会导致状态过早变为CONNECTION_BAD。在这种情况下，应用程序可以尝试通过调用进行恢复PQreset。
-
返回值 ConnStatusType：连接状态的枚举，包括： 1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23 CONNECTION_STARTED
等待进行连接。
CONNECTION_MADE
连接成功；等待发送。
CONNECTION_AWAITING_RESPONSE
等待来自服务器的响应。
CONNECTION_AUTH_OK
已收到认证；等待后端启动结束。
CONNECTION_SSL_STARTUP
协商SSL加密。
CONNECTION_SETENV
协商环境驱动的参数设置。
CONNECTION_OK
连接正常。
CONNECTION_BAD
连接故障。
-
原型 PGconn *PQsetdbLogin(const char *pghost,
const char *pgport,
const char *pgoptions,
const char *pgtty,
const char *dbName,
const char *login,
const char *pwd);
