安裝 psql 指令列工具

如要從指令列連線至 AlloyDB for PostgreSQL 執行個體，您可以在 macOS、Linux 或 Windows 上安裝 psql 用戶端工具。psql 指令列工具是 PostgreSQL 的終端機前端，gcloud beta alloydb connect 指令需要使用這項工具，而且這項工具也用於直接連線至資料庫。

macOS

如要在 macOS 上安裝 psql，建議使用 Homebrew：

  1. 安裝 postgresql 套件：

    brew install postgresql

  2. 安裝完成後，請按照終端機輸出內容中的操作說明，將 psql 新增至 PATH。例如：

    echo 'export PATH="/opt/homebrew/opt/postgresql@18/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

Linux (Debian 或 Ubuntu)

使用發行版本的套件管理工具安裝 PostgreSQL 用戶端：

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

如需其他發行版本，請參閱官方 PostgreSQL 下載頁面。

Windows

如要在 Windows 上安裝 psql，可以使用互動式安裝程式。

安裝程式

  1. 從 PostgreSQL 下載頁面下載 Windows 版 PostgreSQL 互動式安裝程式。
  2. 執行安裝程式。系統提示選取元件時，您可以只安裝指令列工具。
  3. 將 PostgreSQL 安裝作業的 bin 目錄 (例如 C:\Program Files\PostgreSQL\18\bin) 新增至系統 PATH 環境變數。

驗證安裝

安裝完成後，請確認 psql 位於 PATH 中，且運作正常：

psql --version

如果安裝正確，輸出內容會顯示 psql 用戶端工具的版本。

後續步驟