vb_isready

功能描述

Vastbase提供了vb_isready工具用于检查Vastbase数据库服务器连接状态，退出状态说明连接检查的结果。

vb_isready返回到shell的退出状态如下所示：

• 0：服务器正常接受连接。

• 1：服务器拒绝连接（例如在启动期间）。

• 2：服务器连接尝试没有响应。

• 3：服务器没有做任何连接尝试（例如无效的参数）。

语法格式

vb_isready [OPTION]...

参数说明

• -d, --dbname=DBNAME

  声明要连接的数据库。

• -q, --quiet

  不显示状态信息。该参数大多用于脚本处理。

• -V, --version

  输出vb_isready的版本并退出。

• -?, --help

  显示vb_isready命令参数帮助并退出。

• -h, --host=HOSTNAME

  声明正在运行服务器的主机名。如果以一个斜线开头，那么用作Unix域套接字的目录。

• -p, --port=PORT

  声明服务器正在监听连接的TCP端口或本地Unix域套接字文件扩展。

• -t, --timeout=SECS

  在返回服务器没有响应之前尝试连接等待的最大秒数。设置为0表示禁用等待。默认是3秒。

• -U, --username=USERNAME

  指定用户连接到数据库，而不是缺省用户。

• -m, --maintenance

  在hot_standby=off时使用维护模式访问数据库。hot_standby请参考GUC参数hot_standby。

使用示例

示例1： 标准用法。

1、执行如下命令检查数据库连接状态。

vb_isready

返回结果为：

/tmp:5432 - accepting connections

2、输出退出状态检查连接结果。

echo $?

返回结果为0，表示数据库连接状态正常。

0

示例2： 使用连接参数到一个关闭的Vastbase数据库。

vb_isready -h localhost -p 5432

返回结果为：

localhost:5432 - no response

2、输出退出状态检查连接结果。

echo $?

返回结果为2，表示服务器尝试连接但没有响应。

2