PHP实战中知识总结 / PgSQL - pg_isready（bin目录文件）

一、pg_isready

pg_isready是一个用来检查一个PostgreSQL数据库服务器的连接状态的工具。其退出状态指定了连接检查的结果：如果服务器正常接受连接，pg_isready返回0给 shell；如果服务器拒绝连接（例如处于启动阶段）则返回1；如果连接尝试没有被相应则返回2；如果没有尝试（例如由于非法参数）则返回3。

二、命令格式

pg_isready [OPTION]...


1、option

参数	说明
-d, --dbname=DBNAME	指定要连接的数据库名
-q, --quiet	不显示状态消息。当脚本编程时有用
-V, --version	打印pg_isready版本并退出
-?, --help	显示有关pg_isready命令行参数的帮助并退出

2、Connection options

参数	说明
-h, --host=HOSTNAME	指定运行服务器的机器的主机名
-p, --port=PORT	指定端口
-t, --timeout=SECS	尝试连接时，在返回服务器不响应之前等待的最大秒数。设置为 0 则禁用。默认值是 3 秒。
-U, --username=USERNAME	作为用户username连接数据库，而不是用默认用户

// 返回状态0-表明服务器正常接受连接
[postgres@izwz91quxhnlkan8kjak5hz bin]$ pg_isready
/tmp:5432 - accepting connections
[postgres@izwz91quxhnlkan8kjak5hz bin]$ echo $?
// 返回状态1-服务器拒绝连接
[postgres@izwz91quxhnlkan8kjak5hz bin]$ pg_isready -h localhost -p 5433
localhost:5433 - rejecting connections
[postgres@izwz91quxhnlkan8kjak5hz bin]$ echo $?
1
// 返回状态2-尝试连接没有被相应
[postgres@izwz91quxhnlkan8kjak5hz bin]$ pg_isready -h localhost -p 5433
localhost:5433 - no response
[postgres@izwz91quxhnlkan8kjak5hz bin]$ echo $?
2