链接字符
表 1 链接字符串
字符串 | 描述 |
---|
host | 要链接的主机名。如果主机名以斜杠开头,则它声明使用Unix域套接字通讯而不是TCP/IP通讯;该值就是套接字文件所存储的目录。如果没有声明host,那么默认是与位于/tmp目录(或者安装数据库的时候声明的套接字目录)里面的Unix-域套接字链接。在没有Unix域套接字的机器上,默认与localhost链接。 |
hostaddr | 与之链接的主机的IP地址,是标准的IPv4地址格式,比如,172.28.40.9。如果机器支持IPv6,那么也可以使用IPv6的地址。如果声明了一个非空的字符串,那么使用TCP/IP通讯机制。 使用hostaddr取代host可以让应用避免一次主机名查找,这一点对于那些有时间约束的应用来说可能是非常重要的。不过,GSSAPI或SSPI认证方法要求主机名(host)。因此,应用下面的规则: - 如果声明了不带hostaddr的host那么就强制进行主机名查找。
- 如果声明中没有host,hostaddr的值给出服务器网络地址;如果认证方法要求主机名,那么链接尝试将失败。
- 如果同时声明了host和hostaddr,那么hostaddr的值作为服务器网络地址。host的值将被忽略,除非认证方法需要它,在这种情况下它将被用作主机名。
须知:- 要注意如果host不是网络地址hostaddr处的服务器名,那么认证很有可能失败。
- 如果主机名(host)和主机地址都没有,那么libpq将使用一个本地的Unix域套接字进行链接;或者是在没有Unix域套接字的机器上,它将尝试与localhost链接。
|
port | 主机服务器的端口号,或者在Unix域套接字链接时的套接字扩展文件名。 |
user | 要链接的用户名,缺省是与运行该应用的用户操作系统名同名的用户。 |
dbname | 数据库名,缺省和用户名相同。 |
password | 如果服务器要求口令认证,所用的口令。 |
connect_timeout | 链接的最大等待时间,以秒计(用十进制整数字符串书写),0或者不声明表示无穷。不建议把链接超时的值设置得小于2秒。 |
client_encoding | 为这个链接设置client_encoding配置参数。除了对应的服务器选项接受的值,你可以使用auto从客户端中的当前环境中确定正确的编码(Unix系统上是LC_CTYPE环境变量)。 |
options | 添加命令行选项以在运行时发送到服务器。 |
application_name | 为application_name配置参数指定一个值,表明当前用户身份。 |
keepalives | 控制客户端侧的TCP保持激活是否使用。缺省值是1,意思为打开,但是如果不想要保持激活,你可以更改为0,意思为关闭。通过Unix域套接字做的链接忽略这个参数。 |
keepalives_idle | 在TCP应该发送一个保持激活的信息给服务器之后,控制不活动的秒数。0值表示使用系统缺省。通过Unix域套接字做的链接或者如果禁用了保持激活则忽略这个参数。 |
keepalives_interval | 在TCP保持激活信息没有被应该传播的服务器承认之后,控制秒数。0值表示使用系统缺省。通过Unix域套接字做的链接或者如果禁用了保持激活则忽略这个参数。 |
keepalives_count | 添加命令行选项以在运行时发送到服务器。例如,设置为-c comm_debug_mode=off,则设置guc参数comm_debug_mode参数的会话的值为off。 |
openGauss 2024-11-26 00:53:32