PostgreSQL은 기업용 애플리케이션에서 널리 사용되는 강력한 오픈소스 관계형 데이터베이스 시스템입니다. 이 가이드에서는 Windows 환경에서 PostgreSQL을 다운로드하고, 설치하고, 설정하며, 정상적으로 작동하는지 테스트하는 과정까지 전체 흐름을 단계별로 안내합니다.
PostgreSQL 다운로드
- postgresql.org/download/windows 페이지에 접속합니다.
- Download the installer(EnterpriseDB 그래픽 설치 프로그램) 버튼을 클릭합니다.
- 사용 중인 운영체제에 맞는 최신 버전을 선택합니다. (64비트 권장)
- 클릭하면 다운로드가 자동으로 시작됩니다.
PostgreSQL 설치하기
다운로드한 설치 프로그램을 실행한 뒤 아래 단계를 따라 진행하세요.
- 1단계: 환영 화면에서 Next를 클릭합니다.
- 2단계: 구성 요소 선택 — PostgreSQL Server, pgAdmin, Command Line Tools, Stack Builder를 모두 기본 선택 상태로 유지합니다.
- 3단계: 설치 경로 지정 — 기본값 사용을 권장합니다.
- 4단계: 데이터 디렉터리 지정 — 역시 기본값 사용을 권장합니다.
- 5단계: 슈퍼유저(postgres) 비밀번호 설정 — 이 비밀번호는 반드시 기억해 두어야 합니다.
- 6단계: 포트 번호 지정 — 기본값은 5432이며, 특별한 사유가 없다면 변경하지 않습니다.
- 7단계: 고급 옵션 — 기본값으로 두고 진행합니다.
- 8단계: 설정 내용을 확인한 후 Next를 클릭해 설치를 시작합니다.
PostgreSQL 설정하기
핵심 설정 파일 두 개는 데이터 디렉터리(예: C:\Program Files\PostgreSQL\16\data\)에 위치합니다.
postgresql.conf
서버의 동작 방식을 제어하는 파일입니다. 원격 접속을 허용하려면 아래와 같이 수정합니다.
# 기본값 (로컬 전용) #listen_addresses = 'localhost' # 모든 접속 허용 listen_addresses = '*'
pg_hba.conf
클라이언트 인증 방식을 제어하는 파일입니다. 로컬 신뢰 연결을 허용하려면 아래 내용을 추가합니다.
# TYPE DATABASE USER ADDRESS METHOD host all all 127.0.0.1/32 trust
두 파일 중 어느 하나라도 수정했다면 변경 사항이 적용되도록 PostgreSQL 서비스를 반드시 재시작해야 합니다.
설치 테스트하기
명령 프롬프트(Command Prompt)를 열고 다음 명령어를 실행합니다.
psql -U postgres
설치가 올바르게 완료되었다면 아래와 같은 화면이 나타납니다.
psql (16.x) Type "help" for help. postgres=#
간단한 쿼리로 정상 동작 여부를 확인할 수 있습니다.
SELECT version();
version ------------------------------------------------------------ PostgreSQL 16.x on x86_64-pc-mingw64, compiled by ... (1 row)
마무리
Windows에서 PostgreSQL을 설치하는 과정은 크게 세 단계로 요약할 수 있습니다. 먼저 그래픽 설치 프로그램을 다운로드하고, 설치 마법사를 통해 비밀번호·포트·데이터 디렉터리 등을 지정한 뒤, 마지막으로 postgresql.conf와 pg_hba.conf 파일을 운영 환경에 맞게 조정하면 됩니다. 설치 후에는 psql 명령어로 접속을 테스트하여 모든 것이 정상적으로 작동하는지 확인하세요.