链接字符

表 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)。因此,应用下面的规则:

  1. 如果声明了不带hostaddr的host那么就强制进行主机名查找。
  2. 如果声明中没有host,hostaddr的值给出服务器网络地址;如果认证方法要求主机名,那么链接尝试将失败。
  3. 如果同时声明了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。

意见反馈
编组 3备份
    openGauss 2024-12-27 00:53:29
    取消