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