[Supabase] 백업파일로 새 프로젝트에 복원하기

📌

무료 플랜을 사용하던 Supabase 프로젝트가 일시정지되어 새 프로젝트를 생성한 뒤 기존 백업 파일을 복원한 과정을 기록합니다.

현재상황

• 무료플랜 사용중
• 기존 프로젝트 일시정지(Paused) 상태
• 백업파일 보유
  : DB(.backup.gz), Storage (.storage.zip)

Session pooler 사용

1. 상단 Connect 버튼을 클릭
2. Connection Method 항목에서 Session pooler 선택
   : 무료 플랜에서는 Direct connection(직접연결)이 IPv6 전용인 경우가 있습니다.
   IPv4 환경에서는 직접연결이 오류가 발생할 수 있으므로 Connection Method를 Session pooler로 변경하여 사용합니다.

DB 복원

1. 다운로드한 DB 백업 파일의 압축 해제 후 프로젝트 폴더에 넣습니다. (백업파일은 복원완료 후 삭제)
2. 터미널에 아래 내용을 입력합니다. 경로는 프로젝트 경로로 설정합니다.

export PGPASSWORD='데이터베이스 비밀번호'

psql \
  -h Host정보 \
  -p Port정보 \
  -U User정보 \
  -d Database정보 \
  -f DB백업파일명.backup

Host정보, Port정보, User정보, Database정보 : Connect → Connection Method 항목 - Session pooler → Connection string에서 확인 가능. 그대로 붙여넣기합니다.

Storage 복원

1. 압축을 해제하면 기존 Storage 버킷 이름과 동일한 폴더가 생성됩니다.

예시

storage/
├── avatars/
├── posts/

새 Supabase 프로젝트에 기존과 동일한 이름의 버킷을 생성합니다. 저는 이미 생성되어있어 그대로 사용했습니다.

2. 각 폴더 안의 모든 파일을 선택하여 Supabase 사이트 Storage → 해당 폴더 버킷에 파일을 드래그 앤 드롭하여 업로드합니다.

예시

avatars/
 ├── image1.png
 ├── image2.png

폴더 자체를 업로드하는 것이 아니라 폴더 내부의 파일(image1.png, image2.png)을 업로드해야 합니다.