Instale a ferramenta de linha de comando psql.

A ferramenta de linha de comando psql é um front-end baseado em terminal para o PostgreSQL. Ele é obrigatório pelo comando gcloud beta alloydb connect e útil para conexões diretas com o banco de dados.

O PostgreSQL tem uma ampla variedade de opções de instalação. Nesta página, descrevemos como instalar o psql no macOS, Linux e Windows.

macOS

Para instalar o psql no macOS, recomendamos usar o Homebrew.

  1. Instale o pacote postgresql:
brew install postgresql
  1. Adicione psql ao seu PATH seguindo as instruções fornecidas na saída do terminal após a conclusão da instalação. Exemplo:
echo 'export PATH="/opt/homebrew/opt/postgresql@18/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

Linux (Debian / Ubuntu)

Use o gerenciador de pacotes da sua distribuição para instalar o cliente do PostgreSQL.

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

Para outras distribuições, consulte a página oficial de download do PostgreSQL (em inglês).

Windows

Para instalar o psql no Windows, use o instalador interativo.

Instalador

  1. Faça o download do instalador interativo do PostgreSQL para Windows na página de downloads do PostgreSQL (em inglês).
  2. Execute o instalador. Quando for solicitado a selecionar componentes, você poderá instalar apenas as Ferramentas de linha de comando.
  3. Adicione o diretório bin da instalação do PostgreSQL (por exemplo, C:\Program Files\PostgreSQL\18\bin) à variável de ambiente PATH do sistema.

Verifique a instalação

Após a instalação, verifique se o psql está no seu PATH e se está funcionando corretamente:

psql --version

Se instalado corretamente, o resultado vai mostrar a versão da ferramenta de cliente psql.

A seguir