pg_isready
pg_isready — 检查PostgreSQL服务器的连接状态
大纲
pg_isready [connection-option...] [option...]
描述
pg_isready是一个用于检查 PostgreSQL数据库服务器连接状态的工具。其退出状态指示连接检查的结果。
选项
-ddbname--dbname=dbname指定要连接的数据库名称。
如果该参数包含一个
=符号，或者以有效的URI 前缀（postgresql://或postgres://）开头，它将被当作一个conninfo字符串处理。更多信息参见第 31.1.1 节。-hhostname--host=hostname指定服务器所在机器的主机名。如果值以斜杠开头，则被用作 Unix 域套接字的目录。
-pport--port=port指定服务器正在监听连接的 TCP 端口，或本地 Unix 域套接字文件扩展名。默认值取自
PGPORT环境变量；如果未设置，则取编译时指定的端口，通常为 5432。-q--quiet不显示状态消息。这在编写脚本时很有用。
-tseconds--timeout=seconds在尝试连接时，返回服务器无响应之前等待的最大秒数。设为 0 表示禁用。默认值为 3 秒。
-Uusername--username=username以用户
username连接到数据库，而不是使用默认用户。-V--version打印pg_isready版本并退出。
-?--help显示有关pg_isready命令行参数的帮助并退出。
退出状态
如果服务器正常接受连接，pg_isready会向
shell 返回0；如果服务器拒绝连接（例如处于启动阶段），则返回1；如果连接尝试未得到响应，则返回
2；如果未发起连接尝试（例如由于参数非法），则返回3。
环境
与大多数其他PostgreSQL工具一样，pg_isready也使用libpq
支持的环境变量（见第 31.14 节）。
注解
选项--dbname和--username可用于避免日志中出现多余的报错消息，但对正常功能而言并非必需。
示例
标准用法：
$pg_isready/tmp:5432 - accepting connections$echo $?0
使用连接参数检查一个处于启动阶段的 PostgreSQL集簇：
$pg_isready -h localhost -p 5433localhost:5433 - rejecting connections$echo $?1
使用连接参数检查一个无响应的 PostgreSQL集簇：
$pg_isready -h someremotehostsomeremotehost:5432 - no response$echo $?2