1.13.?ux_isready

1.13.1. 用法
1.13.2. 描述
1.13.3. 选项
1.13.4. 退出状态
1.13.5. 环境变量
1.13.6. 注解
1.13.7. 示例

ux_isready — 检查一个UXDB服务器的连接状态

1.13.1.?用法

ux_isready [connection-option...] [option...]

1.13.2.?描述

ux_isready是一个用来检查一个UXDB数据库服务器的连接状态的工具。其退出状态指定了连接检查的结果。

1.13.3.?选项

-d dbname
--dbname=dbname

指定要连接的数据库名。

如果这个参数包含一个=记号或者以一个合法的URI前缀(UXDB://uxdb://)开始,它会被当作一个conninfo字符串。

-h hostname
--host=hostname

指定运行服务器的机器的主机名。如果该值以一个斜线开始,它被用作 Unix 域套接字的目录。

-p port
--port=port

指定服务器正在监听连接的 TCP 端口或本地 Unix 域套接字文件扩展。默认值取自UXPORT环境变量。如果环境变量没有设置,则默认值使用编译时指定的端口(通常是 5432)。

-q
--quiet

不显示状态消息。当脚本编程时有用。

-t seconds
--timeout=seconds

尝试连接时,在返回服务器不响应之前等待的最大秒数。设置为0则禁用。默认值是3秒。

-U username
--username=username

作为用户username连接数据库,而不是用默认用户。

-V
--version

打印ux_isready版本并退出。

-?
--help

显示有关ux_isready命令行参数的帮助并退出。

1.13.4.?退出状态

如果服务器正常接受连接,ux_isready返回0给shell;如果服务器拒绝连接(例如处于启动阶段)则返回1;如果连接尝试没有被相应则返回2;如果没有尝试(例如由于非法参数)则返回3

1.13.5.?环境变量

和大部分其他UXDB工具相似,ux_isready也使用libpq支持的环境变量。

1.13.6.?注解

要获得服务器状态,不一定需要提供正确的用户名、口令或数据库名。不过,如果提供了不正确的值,服务器将会记录一次失败的连接尝试。

1.13.7.?示例

标准用法:

$ ux_isready
/tmp:5432 - accepting connections
$ echo $?
0

使用连接参数运行连接到处于启动中的UXDB集群:

$ ux_isready -h localhost -p 5433
localhost:5433 - rejecting connections
$ echo $?
1

使用连接参数运行连接到无响应的UXDB集群:

$ ux_isready -h someremotehost
someremotehost:5432 - no response
$ echo $?
2

XML 地图 | Sitemap 地图