qhb_isready - проверка состояние соединения с сервером QHB
Синтаксис
qhb_isready [FLAGS] [OPTIONS]
Описание
qhb_isready - это утилита для проверки состояния соединения с сервером
базы данных QHB. Статус выхода определяет результат проверки
соединения.
Параметры
FLAGS:
| Аргумент | Описание |
|---|---|
| -?, --help | Показать справку об аргументах командной строки и выйти. |
| --no-timeout | Запустить приложение без тайм-аута, используется вместо -t 0s |
| -q, --quiet | Устанавливает уровень ведения журнала в Error, конфликтует с флагом verbose. |
| -V, --version | Вывести версию qhb_isready и выйти. |
| -v, --verbose | Устанавливает уровень ведения журнала в Debug (по умолчанию: Info). |
OPTIONS:
| Аргумент | Описание |
|---|---|
| -d, --dbname DBNAME | Определяет имя базы данных для подключения (env: PGDATABASE). |
| -h, --host HOST | Указывает имя хоста компьютера, на котором работает сервер. Если значение начинается с косой черты, оно используется как каталог для сокета Unix-домена. (env:PGHOST) |
| -p, --port PORT | Указывает порт TCP или расширение файла локального сокета Unix-домена, на котором сервер прослушивает соединения. По умолчанию используется значение переменной среды (env: PGPORT) или, если не установлено, значение порта, указанного во время компиляции, обычно 5432. |
| -t, --timeout TIMEOUT | Максимальное количество секунд ожидания при попытке соединения, поддерживает «человеческое время», например -t 3s. |
| -U, --username USERNAME | Подключение к базе данных с использованием имени пользователя вместо имени по умолчанию. (env: PGUSER) |
Статус выхода
qhb_isready возвращает оболочке:
| Код выхода | Условия |
|---|---|
| 0 | сервер принимает соединения нормально |
| 1 | сервер отклоняет соединения (например, во время запуска или неверно заданных аргументов: --no-existent-arg) |
| 2 | не было ответа на попытку соединения |
| 3 | попытка не была предпринята (например, из-за неверных параметров аргумента(ов)) |
Примечания
Для получения статуса сервера необязательно указывать правильные значения имени пользователя, пароля или имени базы данных; однако, если указаны неправильные значения, сервер зарегистрирует неудачную попытку подключения.
Примеры
Стандартное использование:
$ qhb_isready echo $?
[INFO] /home/user/qhb/core_db/build/dbsockets:5432 - accepting connections
0
Запуск с параметрами подключения к неотвечающему кластеру QHB:
$ qhb_isready --host localhost --port 22; echo $?
[WARN] Unable to load login packet: Provided buffer (66560) is shorter than a packet length (body_length = 1397239086, packet_id = 83 (S), raw_length = 1397239090).
[ERROR] localhost:22 - connection rejected
1
Ошибка при попытке установить подключение
$ qhb_isready --host localhost --port 42; echo $?
[WARN] ConnectionError: failed to connect to 127.0.0.1:42: Failed to establish connection to 127.0.0.1:42: Connection refused (os error 111)
[ERROR] localhost:42 - no response
2
Запуск с некорректными параметрами
$ qhb_isready --host asd; echo $?
[WARN] Failed to lookup address asd: failed to lookup address information: Name or service not known
[ERROR] asd:5432 - incorrect parameters
3