# PostgreSQL pg_dump · pg_restore 사용법 및 로컬 DB 복원 정리

DB 사용하다 보면 클라우드나 다른 서버에서 데이터를 백업(덤프)하고,

이를 로컬 환경으로 복원해야 할 일이 자주 생깁니다.

이 글에서는 pg_dump로 백업을 만들고, pg_restore를 이용해 로컬 DB·특정 스키마에 복원하는 전체 과정을 정리해보겠습니다.

---

1. pg_dump로 DB 백업(dump) 만들기

백업(dump) 생성은 PostgreSQL의 pg_dump를 이용합니다.
Custom format(-F c)으로 백업하면 나중에 pg_restore로 스키마 단위 복원이 가능합니다.

 

예시 명령

pg_dump -h {host} -U {user} -d {database} -F c -f "경로\파일명.dump"

 

옵션 설명

옵션	설명
-h	접속할 서버 주소. Render 등 외부 서버일 경우 외부 호스트, 로컬은 localhost
-U	PostgreSQL 사용자명
-d	백업할 DB 이름
-F c	Custom format (pg_restore로 복원 가능)
-f	출력 파일 경로

 

---

2. localhost 확인 (로컬 PostgreSQL 서버 목록 확인)

로컬 DB에 복원하기 전에, 내 PC에서 어떤 DB가 존재하는지 확인해 보겠습니다.
이 명령은 **CMD(명령 프롬프트)**에서 실행해야 합니다.

psql -h localhost -U postgres -l

대부분 설치 직후에는 아래 3개가 보입니다.

DB 이름	설명
postgres	기본 DB (우리가 주로 복원하게 되는 DB)
template0	시스템 템플릿 DB
template1	새로운 DB 생성 시 기본 템플릿

즉, 로컬에서 우리가 사용할 DB는 대부분 postgres DB입니다.

---

3. pg_restore를 이용한 로컬 DB 복원

3-1. 특정 스키마(abc)에 복원

이미 로컬 DB(postgres)에 abc스키마가 존재한다고 가정하면:

pg_restore -h localhost -U postgres -d postgres -n abc "C:\경로\파일.dump"

 

옵션 설명

옵션	설명
-d postgres	로컬의 postgres DB에 복원
-n split	split 스키마에만 복원
"파일.dump"	백업본 파일 경로

 

주의

dump 안의 원본 스키마가 public이면 abc로 들어가지 않을 수도 있다. 그럴 땐 아래 옵션 사용해야 한다.

pg_restore -h localhost -U postgres -d postgres -N public --schema=abc "C:\경로\파일.dump"

---

4. 복원 결과 확인

복원 후 아래 명령으로 테이블이 정상적으로 들어왔는지 확인할 수 있다.

스키마의 테이블 목록 보기

\dt abc.*

---

 

5. 정리

• pg_dump → DB 전체를 백업하는 도구
• pg_restore → Custom format dump를 복원하는 도구
• 로컬 복원 시 -h localhost를 사용하면 내 PC에만 복원되므로 다른 서버에 영향을 주지 않는다
• dump 생성 시 원본 스키마 구조에 따라 복원할 스키마 옵션이 다를 수 있다
• pgAdmin의 SQL 창에서는 pg_restore가 동작하지 않음 → 반드시 CMD에서 실행해야 함