Instala la herramienta de línea de comandos psql

La herramienta de línea de comandos de psql es un frontend basado en terminal para PostgreSQL. El comando gcloud beta alloydb connect lo requiere y es útil para las conexiones directas a la base de datos.

PostgreSQL tiene una amplia variedad de opciones de instalación. En esta página, se describe cómo instalar psql en macOS, Linux y Windows.

macOS

Para instalar psql en macOS, te recomendamos que uses Homebrew.

  1. Instala el paquete postgresql:
brew install postgresql
  1. Agrega psql a tu PATH siguiendo las instrucciones que se proporcionan en el resultado de la terminal después de que se complete la instalación. Por ejemplo:
echo 'export PATH="/opt/homebrew/opt/postgresql@18/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

Linux (Debian / Ubuntu)

Usa el administrador de paquetes de tu distribución para instalar el cliente de PostgreSQL.

sudo apt-get update
sudo apt-get install postgresql-client

Para otras distribuciones, consulta la página oficial de descargas de PostgreSQL.

Windows

Para instalar psql en Windows, puedes usar el instalador interactivo.

Instalador

  1. Descarga el instalador interactivo de PostgreSQL para Windows desde la página de descargas de PostgreSQL.
  2. Ejecuta el instalador. Cuando se te solicite que selecciones componentes, puedes instalar solo Command Line Tools.
  3. Agrega el directorio bin de tu instalación de PostgreSQL (por ejemplo, C:\Program Files\PostgreSQL\18\bin) a la variable de entorno PATH de tu sistema.

Verifique la instalación

Después de la instalación, verifica que psql esté en tu PATH y que funcione correctamente:

psql --version

Si se instaló correctamente, el resultado muestra la versión de la herramienta de cliente psql.

¿Qué sigue?