1. 서버·pgAdmin·psql 구분
PostgreSQL은 데이터를 관리하는 DB 서버입니다. pgAdmin은 관리 GUI, psql은 터미널 클라이언트입니다. DBeaver 같은 다른 GUI로도 지원 드라이버를 통해 접속할 수 있으며, 어느 클라이언트를 쓰든 실제 서버·계정이 필요합니다.
| 구성요소 | 역할 |
|---|---|
| PostgreSQL Server | DB 파일·SQL 요청과 접속 처리 |
| pgAdmin | DB 관리·SQL 작업용 GUI |
| StackBuilder | 추가 도구·드라이버·확장 배포 준비 |
| psql | 명령줄에서 접속하고 SQL 입력 |
클라이언트가 설치됐다는 사실과 서버가 실행 중이라는 사실은 다릅니다. 기존 서버에 접속하려는 경우에는 PC에 새 서버를 중복 설치하기 전에 제공받은 접속 정보를 확인하세요.
2. 다운로드와 안정판 선택
다운로드 버튼은 PostgreSQL 공통 다운로드 화면을 엽니다. OS를 고른 뒤 해당 패키지·설치 제공자를 선택하세요. Windows 안내는 EDB로 연결하며 Linux는 배포판 패키지 경로 등 선택이 다를 수 있습니다.
공식 사이트의 Beta/RC는 새 기능 시험용으로 구분됩니다. 확인 시점에는 18 계열 안정판과 19 RC1 안내가 함께 보이므로 가장 큰 숫자만 보고 운영용 버전을 고르지 마세요. 기존 앱·확장·호스팅이 지원하는 계열과 해당 계열의 최신 수정 배포를 확인합니다.
PostgreSQL 자체는 무료 오픈소스입니다. 클라우드 DB·유료 지원·다른 제공자의 부가 서비스 비용과 구분하세요. Windows Server 테스트 목록은 일반 PC 최소 OS 사양표와 같지 않습니다.
3. 새 로컬 환경 설치
- 공식 공통 화면에서 OS와 설치 패키지 또는 배포판 안내를 선택합니다.
- 새 연습 환경에서 설치할 서버·관리 도구 구성요소를 확인하고 프로그램과 데이터를 저장할 경로를 구분합니다.
- 설치 방식이 요구하는 계정·인증과 접속 포트, 서비스 시작 상태를 확인합니다. 기본 포트는 5432이며 중복 서버가 있다면 실제 값을 대조합니다.
- 설치한 psql·pgAdmin 또는 다른 GUI에서 로컬 주소·포트·DB 이름과 계정을 지정해 연결합니다.
이미 사용하던 데이터 디렉터리를 새 버전 설치 과정에서 초기화하지 마세요. OS 패키지와 EDB 설치 방식은 메뉴·서비스 관리가 같지 않으므로 선택한 방식의 공식 안내를 따릅니다.
4. 기본 접속과 첫 SQL
아래는 공식 튜토리얼과 접속 옵션을 바탕으로 한 로컬 시험 서버 예시입니다. learner와 demo는 실제로 준비한 계정·DB 이름으로 바꾸세요. psql 명령을 찾지 못하면 설치한 클라이언트의 실행 경로를 확인합니다.
psql -h 127.0.0.1 -p 5432 -U learner -d demo
접속 후 다음 읽기 전용 문장으로 서버 버전과 기본 응답을 확인할 수 있습니다. 이 조회는 테이블 데이터를 수정하지 않습니다.
SELECT version(); SELECT 1 AS connection_check;
GUI를 원하면 DBeaver의 PostgreSQL 연결 준비에서 Database 입력과 Host/URL 방식의 표시 차이를 확인하세요. 표시되는 DB 목록을 늘리는 설정이 새 접근 권한을 부여하는 것은 아닙니다.
5. 확장과 다른 DB 선택
사용자 정의 타입·함수와 확장성은 PostgreSQL의 선택 요소입니다. PostGIS 같은 확장이 필요하면 해당 확장의 설치 배포·OS·DB 메이저 호환을 함께 확인하세요. 모든 확장이 기본 설치만으로 준비됐다고 생각하지 않습니다.
기존 프로젝트가 MySQL을 요구한다면 데이터베이스 이름만 바꿔 연결해도 호환된다고 볼 수 없습니다. MySQL·PostgreSQL 비교에서 프로젝트 호환·필요 기능·유지 조건으로 먼저 골라보세요.
6. 접속 오류와 버전 유지
- 서버 연결 실패: 서비스 실행·실제 주소·포트와 네트워크를 확인합니다.
- 인증 실패: 지정한 계정·인증 방식·암호와 접속 허용 조건을 대조합니다. 인증 검증을 해제하지 않습니다.
- DB를 못 찾음: 접속한 서버와 Database 이름을 확인합니다. GUI의 표시·필터와 실제 권한은 구분합니다.
- 메이저 변경: 공식 정책의 pg_upgrade 또는 dump/reload 같은 이전 절차가 필요합니다. 새 바이너리를 기존 데이터 폴더에 덮어쓰는 것으로 끝내지 않습니다.
메이저 계열은 최초 출시 후 5년의 커뮤니티 지원이 안내됩니다. 지원 종료일과 현재 수정 배포는 공식 정책에서 다시 확인하세요. 제거·초기화 전에는 데이터와 백업을 별도로 보존합니다.
7. JSON 데이터와 문서 DB 선택
PostgreSQL은 관계형 테이블 안에서 json·jsonb로 JSON을 저장·조회할 수 있습니다. SQL·관계·제약을 쓰면서 일부 필드를 JSON으로 두는 선택도 가능하므로 JSON을 사용한다는 이유만으로 다른 DB가 필요한 것은 아닙니다.
json은 입력 텍스트를 저장하고 jsonb는 분해된 이진 표현과 인덱싱을 지원합니다. jsonb는 공백·객체 키 순서·중복 키 원본을 그대로 보존하지 않습니다. 필요한 질의와 원문 보존 조건을 보고 고르세요.
MongoDB·PostgreSQL 데이터 모델 비교는 문서의 임베딩/참조와 관계·SQL·JSON 사용을 나눠 선택합니다. 이 비교를 이유로 기존 서버와 데이터를 즉시 교체하지 않습니다.
8. DB 엔진과 앱 백엔드 플랫폼
Supabase는 Postgres를 중심으로 인증·데이터 API·파일·함수 등을 묶은 플랫폼입니다. PostgreSQL 서버 설치가 필요한지, 앱의 여러 백엔드 기능이 필요한지 먼저 구분하세요. Appwrite도 별도의 프로젝트·SDK·권한 모델을 가진 플랫폼입니다.
플랫폼 클라이언트의 API 키와 psql·GUI에서 쓰는 DB 계정·접속 정보는 역할이 다릅니다. Supabase의 공개용 publishable 키와 서버 secret 키도 구분해야 하며, 노출 테이블의 권한·RLS·정책을 함께 확인합니다. API 응답 성공을 사용자별 자료 접근 검수까지 끝난 상태로 보지 않습니다.
9. ORM 클라이언트 생성과 스키마 적용
Prisma ORM·Drizzle ORM은 앱에서 쿼리·타입·스키마를 관리하는 계층입니다. PostgreSQL 서버·계정·네트워크를 대신하는 것은 아니며, 클라이언트/타입 생성과 DB의 실제 테이블 변경 적용은 별도로 확인해야 합니다.
개발 DB에서 빠르게 구조를 바꾸는 흐름과 운영 DB에 검토된 변경 이력을 적용하는 흐름은 다릅니다. Prisma 7의 migrate dev·reset은 운영용이 아니고 초기화가 수반될 수 있습니다. 사용하는 도구·계열의 문서, 생성 SQL·변경 이력과 대상 DB·백업을 먼저 대조하세요.
10. 주요 기능
- SQL 기반 객체 관계형 DB 서버
- 트랜잭션·제약과 데이터 무결성 기능
- 사용자 정의 타입·함수와 확장
- 여러 플랫폼의 공식 패키지 안내
- psql·pgAdmin·외부 GUI 연결
- 메이저 버전별 커뮤니티 지원 정책
11. 시스템 요구사항
- 지원 기기
- Windows·macOS·Linux 등 · OS별 공식 패키지 확인
- 구성요소
- DB 서버와 pgAdmin·psql·추가 도구 역할 구분
- 기본 접속
- 서버 실행·실제 포트·DB 이름·허용 계정
- 버전
- 안정판/시험판과 앱·확장 호환·지원 종료일 확인
- 기존 데이터
- 메이저 업그레이드와 새 설치·제거 절차 분리
12. 설치·기본 접속
- 1.
PostgreSQL 다운로드 버튼에서 운영체제와 설치 제공자를 선택합니다.
- 2.
새 환경에서 서버·관리 도구의 구성과 프로그램/데이터 경로를 확인해 설치합니다.
- 3.
서버 실행·포트·계정·DB 이름을 확인하고 psql 또는 GUI로 접속합니다.
- 4.
시험 DB에서 읽기 전용 SQL로 응답을 확인합니다. 기존 데이터 이전은 선택 계열의 공식 절차를 따릅니다.
13. PostgreSQL와 비슷한 프로그램 비교
- MySQL
- 관계형 DB 서버의 다른 선택지입니다. 기존 앱 호환·필요 기능·릴리스 유지 조건을 비교합니다.
- SQLite
- 앱에 내장하는 파일 DB입니다. 서버 운용과 여러 클라이언트 접속이 필요한지부터 구분합니다.
- MariaDB
- MySQL 계열 생태계의 별도 서버 프로젝트입니다. 드라이버·SQL·버전 호환은 실제 요구에 맞춰 확인합니다.
14. 자주 묻는 질문
PostgreSQL과 pgAdmin은 같은 프로그램인가요?
+
PostgreSQL은 DB 서버이고 pgAdmin은 관리 GUI입니다. psql이나 DBeaver 같은 클라이언트로도 서버에 연결할 수 있습니다.
Windows에서 EDB로 이동해도 되나요?
+
PostgreSQL 공식 Windows 다운로드 안내가 EDB 설치 제공자로 연결합니다. 공통 다운로드 버튼에서 OS를 선택한 뒤 안내된 제공자를 확인하세요.
PostgreSQL은 무료인가요?
+
PostgreSQL License의 무료 오픈소스입니다. 별도 호스팅·지원 서비스나 외부 부가 제품에는 다른 비용과 조건이 있을 수 있습니다.
19 RC가 보이면 그 버전을 설치해야 하나요?
+
RC는 시험용 후보 배포입니다. 운영용으로는 공식 안정판과 기존 앱·확장의 지원 계열을 확인하세요.
새 버전을 설치하면 기존 DB가 자동 이전되나요?
+
메이저 버전 변경에는 별도 이전 절차가 필요합니다. 기존 데이터 디렉터리에 새 바이너리를 덮어쓰는 기본 설치 안내로 처리하지 않습니다.
PostgreSQL에서도 JSON을 저장할 수 있나요?
+
json·jsonb 타입을 지원하며 관계형 테이블·SQL과 함께 사용할 수 있습니다. 두 타입의 표현·원문 보존·인덱싱 차이를 확인하세요.
Supabase API 키로 psql에 접속하나요?
+
앱 API와 DB 클라이언트 연결은 다릅니다. 플랫폼이 안내하는 DB 접속 방식·DB 계정과 적절한 앱 API 키를 각각 확인하세요.
ORM 타입을 생성하면 PostgreSQL도 변경되나요?
+
클라이언트·타입 생성과 DB 스키마 적용은 다릅니다. 변경 이력과 실제 대상 DB를 별도로 확인하세요.
출처: PostgreSQL — 기능·확장과 개발 주체, PostgreSQL — 공식 다운로드 공통 화면, PostgreSQL — Windows 배포 구성·EDB 안내
관련 가이드
관련 프로그램