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. 설치 프로그램을 실행합니다. 구성요소를 선택하라는 메시지가 표시되면 명령줄 도구만 설치하면 됩니다.
  3. PostgreSQL 설치의 bin 디렉터리 (예: C:\Program Files\PostgreSQL\18\bin)를 시스템 PATH 환경 변수에 추가합니다.

설치 확인

설치 후 psql가 PATH에 있고 올바르게 작동하는지 확인합니다.

psql --version

올바르게 설치되면 출력에 psql 클라이언트 도구의 버전이 표시됩니다.

다음 단계