# 皮克_准备好了
皮克_isready — 检查 PostgreSQL 服务器的连接状态
# 概要
pg_isready
[连接选项
...][option
...]
# 描述
皮克_isready 是一个用于检查 PostgreSQL 数据库服务器连接状态的实用程序。退出状态指定连接检查的结果。
# 选项
-d *
数据库名称*
--dbname=*
数据库名称*
指定要连接的数据库的名称。这*数据库名称
*可以是一个连接字符串.如果是这样,连接字符串参数将覆盖任何冲突的命令行选项。
-h *
主机名*
--主机=*
主机名*
指定运行服务器的机器的主机名。如果该值以斜杠开头,则将其用作 Unix 域套接字的目录。
-p *
港口*
--端口=*
港口*
指定服务器正在侦听连接的 TCP 端口或本地 Unix 域套接字文件扩展名。默认值为PGPORT
环境变量,如果未设置,则为编译时指定的端口,通常为 5432.
-q
- 安静的
不显示状态消息。这在编写脚本时很有用。
-t *
秒*
--超时=*
秒*
在返回服务器未响应之前尝试连接时等待的最大秒数。设置为 0 禁用。默认值为 3 秒。
-U *
用户名*
--用户名=*
用户名*
以用户身份连接到数据库*用户名
*而不是默认值。
-V
- 版本
打印 pg_isready 版本并退出。
-?
- 帮助
显示关于 pg 的帮助_isready 命令行参数,然后退出。
# 退出状态
皮克_已准备好返回0
如果服务器正常接受连接,则发送到 shell,1
如果服务器拒绝连接(例如在启动期间),2
如果对连接尝试没有响应,并且3
如果没有尝试(例如由于无效参数)。
# 环境
pg_isready
与大多数其他 PostgreSQL 实用程序一样,也使用 libpq 支持的环境变量(请参阅第 34.15 节)。
环境变量PG_COLOR
指定是否在诊断消息中使用颜色。可能的值为总是
,汽车
和绝不
.
# 笔记
无需提供正确的用户名、密码或数据库名称值即可获取服务器状态;但是,如果提供了不正确的值,服务器将记录失败的连接尝试。
# 例子
标准用法:
$ pg_isready
/tmp:5432 - accepting connections
$ echo $?
0
在启动时使用与 PostgreSQL 集群的连接参数运行:
$ pg_isready -h localhost -p 5433
localhost:5433 - rejecting connections
$ echo $?
1
使用连接参数运行到无响应的 PostgreSQL 集群:
$ pg_isready -h someremotehost
someremotehost:5432 - no response
$ echo $?
2