psql コマンドライン ツールをインストールする

psql コマンドライン ツールは、PostgreSQL のターミナルベースのフロントエンドです。 gcloud beta alloydb connect コマンドで必要となり、 データベースに直接接続する場合に便利です。

PostgreSQL にはさまざまなインストール オプションがあります。このページでは、macOS、Linux、Windows に psql をインストールする方法について説明します。

macOS

macOS に psql をインストールするには、Homebrew を使用することをおすすめします。

  1. postgresql パッケージをインストールします。
brew install postgresql
  1. インストールが完了したら、ターミナル出力に表示される手順に沿って 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. インストーラを実行します。コンポーネントの選択を求められたら、[Command Line Tools] のみインストールできます。
  3. PostgreSQL のインストール ディレクトリ（たとえば C:\Program Files\PostgreSQL\18\bin）の bin ディレクトリを、システムの PATH 環境 変数に追加します。

インストールを確認する

インストール後、psql が PATH に含まれていて、正しく動作していることを確認します。

psql --version

正しくインストールされている場合は、出力に psql クライアント ツールのバージョンが表示されます。

次のステップ