pg_isready — comprueba el estado de la conexión de un servidor PostgreSQL
pg_isready [connection-option...] [option...]
pg_isready es una utilidad para comprobar el estado de la conexión de un servidor de bases de datos PostgreSQL. El estado de salida especifica el resultado de la comprobación de la conexión.
-d dbname--dbname=dbname
Especifica el nombre de la base de datos a la que conectarse. El
dbname puede ser una cadena de conexión. Si es así, los
parámetros de la cadena de conexión anularán cualquier opción de línea
de comandos en conflicto.
-h hostname--host=hostnameEspecifica el nombre de host de la máquina en la que se está ejecutando el servidor. Si el valor comienza con una barra diagonal, se utiliza como el directorio para el socket de dominio Unix.
-p port--port=port
Especifica el puerto TCP o la extensión del archivo de socket de
dominio Unix local en el que el servidor está escuchando
conexiones. El valor por defecto es el de la variable de entorno PGPORT
o, si no está definida, el puerto especificado en el momento de la compilación,
normalmente 5432.
-q--quietNo muestra mensajes de estado. Esto es útil al escribir scripts.
-t seconds--timeout=secondsEl número máximo de segundos a esperar al intentar la conexión antes de devolver que el servidor no responde. Si se establece en 0, se desactiva. El valor por defecto es 3 segundos.
-U username--username=username
Se conecta a la base de datos como el usuario username en lugar del predeterminado.
-V--versionMuestra la versión de pg_isready y termina.
-?--helpMuestra la ayuda sobre los argumentos de línea de comandos de pg_isready y termina.
pg_isready devuelve 0 al shell si el servidor
está aceptando conexiones normalmente, 1 si el servidor está rechazando
conexiones (por ejemplo, durante el inicio), 2 si no hubo respuesta al
intento de conexión, y 3 si no se realizó ningún intento (por ejemplo, debido a
parámetros no válidos).
pg_isready, al igual que la mayoría de las otras utilidades de PostgreSQL,
también utiliza las variables de entorno admitidas por libpq
(véase Section 32.15).
La variable de entorno PG_COLOR especifica si se debe usar
color en los mensajes de diagnóstico. Los valores posibles son
always, auto y
never.
No es necesario proporcionar valores correctos de nombre de usuario, contraseña o nombre de base de datos para obtener el estado del servidor; sin embargo, si se proporcionan valores incorrectos, el servidor registrará un intento de conexión fallido.
Uso estándar:
$pg_isready/tmp:5432 - aceptando conexiones$echo $?0
Ejecución con parámetros de conexión a un clúster de PostgreSQL en inicio:
$pg_isready -h localhost -p 5433localhost:5433 - rechazando conexiones$echo $?1
Ejecución con parámetros de conexión a un clúster de PostgreSQL que no responde:
$pg_isready -h someremotehostsomeremotehost:5432 - sin respuesta$echo $?2