Instalar a ferramenta de linha de comando psql

Para se conectar à instância do AlloyDB para PostgreSQL pela linha de comando, instale a ferramenta cliente psql no macOS, Linux ou Windows. A ferramenta de linha de comando psql é um front-end baseado em terminal para o PostgreSQL que é exigido pelo comando gcloud beta alloydb connect e também é usado para conexões diretas de banco de dados.

macOS

Para instalar o psql no macOS, recomendamos o uso do Homebrew:

  1. Instale o pacote postgresql:

    brew install postgresql

  2. Adicione psql ao 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 ou Ubuntu)

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

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

Para outras distribuições, consulte a página oficial de download do PostgreSQL.

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.
  2. Execute o instalador. Quando for solicitado que você selecione componentes, instale 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 psql está no PATH e se está funcionando corretamente:

psql --version

Se a instalação estiver correta, a saída vai mostrar a versão da ferramenta cliente psql.

A seguir