psql 명령줄 도구 설치

명령줄에서 PostgreSQL용 AlloyDB 인스턴스에 연결하려면 macOS, Linux 또는 Windows에 psql 클라이언트 도구를 설치하면 됩니다. psql 명령줄 도구는 gcloud beta alloydb connect 명령어에 필요한 PostgreSQL의 터미널 기반 프런트엔드이며 직접 데이터베이스 연결에도 사용됩니다.

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 클라이언트 도구 버전이 표시됩니다.

다음 단계