# 皮克_准备好了

皮克_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