pg_isready — 检查一个PostgreSQL服务器的连接状态
pg_isready
[connection-option
...] [option
...]
pg_isready是一个用来检查一个PostgreSQL数据库服务器的连接状态的工具。其退出状态指定了连接检查的结果。
-d dbname
--dbname=dbname
指定要连接的数据库名。dbname
可以是连接字符串。如果是这样,连接字符串参数将覆盖任何冲突的命令行选项。
-h hostname
--host=hostname
指定运行服务器的机器的主机名。如果该值以一个斜线开始,它被用作 Unix 域套接字的目录。
-p port
--port=port
指定服务器正在监听连接的 TCP 端口或本地 Unix 域套接字文件扩展。默认值取自PGPORT
环境变量。如果环境变量没有设置,则默认值使用编译时指定的端口(通常是 5432)。
-q
--quiet
不显示状态消息。当脚本编程时有用。
-t seconds
--timeout=seconds
尝试连接时,在返回服务器不响应之前等待的最大秒数。设置为 0 则禁用。默认值是 3 秒。
-U username
--username=username
作为用户username
连接数据库,而不是用默认用户。
-V
--version
打印pg_isready版本并退出。
-?
--help
显示有关pg_isready命令行参数的帮助并退出。
如果服务器正常接受连接,pg_isready返回0
给 shell;如果服务器拒绝连接(例如处于启动阶段)则返回1
;如果连接尝试没有被相应则返回2
;如果没有尝试(例如由于非法参数)则返回3
。
和大部分其他PostgreSQL工具相似,pg_isready
也使用libpq(见第 33.14 节)支持的环境变量。
环境变量PG_COLOR
规定在诊断消息中是否使用颜色。可能的值为always
、auto
、never
。
要获得服务器状态,不一定需要提供正确的用户名、口令或数据库名。 不过,如果提供了不正确的值,服务器将会记录一次失败的连接尝试。
标准用法:
$
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
既然已经学了execute和normal!,我们就可以深入探讨一个Vimscript惯用法。 执行下面的命令::execute "normal! gg/foocrdd"这将...
SVG path path 元素应该是 SVG 中最常见的形状。你可以通过 path 元素绘制矩形(直角矩形或者圆角矩形)、圆形、椭圆、折线形、...
XML Schema group 元素 完整 XML Schema 参考手册定义和用法 group 元素用于定义在复杂类型定义中使用的元素组。 元素信息 父元...
您已经学习了 XML Schema,下一步学习什么呢? 本节对XMLSchema 的知识点进行总结。XML Schema 概要 本教程已经向您讲解了如何描...