본문으로 건너뛰기

SQL 덤프 파일 업로드

이 가이드를 따라가면 직접 만들었거나 전달받은 SQL 덤프 파일을 KIOPS에 업로드하여 데이터 패키지 저장소에 보관할 수 있습니다. 협력 업체에서 받은 pg_dump 결과나 다른 환경에서 받은 mysqldump 결과를 KIOPS에 등록해 두고, 이후 필요할 때 target DB에 적용하는 흐름의 첫 단계입니다.

업로드 자체는 target DB에 곧바로 적용하지 않습니다. 파일을 고르면 즉시 저장소에 보관되고, 적용은 데이터 패키지 저장소 활용 가이드의 절차로 진행합니다.

시작하기 전에: 알아둘 용어​

  • SQL 덤프: DB의 구조와 데이터를 SQL 명령으로 저장한 파일입니다. .sql 평문 또는 .sql.gz gzip 압축 형식을 지원합니다.
  • 데이터 패키지: KIOPS 안에 보관해 둔 SQL 덤프 묶음입니다. 업로드 시점·DB 타입·적용 이력을 함께 보관합니다.
  • target DB: 덤프를 풀어 넣을 목적지 DB입니다. 적용 단계에서 KIOPS DB 연결 탭에 등록된 연결 중에서 고릅니다.
  • append 모드: 덤프의 CREATE/INSERT를 그대로 적용하는 모드입니다. 기존 테이블과 PK/UK가 겹치면 실패할 수 있습니다.
  • replace 모드: 대상 스키마/데이터를 비우고 덤프 내용으로 채우는 모드입니다 (데이터 손실 주의).

사전 준비​

권한과 파일 준비
  • 데이터베이스 관리 권한: [데이터베이스 관리] 페이지와 데이터 패키지 탭이 보여야 합니다. 보이지 않으면 기관 관리자에게 권한을 요청하세요.
  • SQL 덤프 파일: 업로드할 .sql 또는 .sql.gz 파일이 로컬 PC에 있어야 합니다.
  • 저장소 여유: 기관 저장소가 5GB 한도 안에 있어야 업로드가 허용됩니다.

덤프 파일 확보하기​

비개발 직군이라면 소스 DB의 IT 담당자에게 다음 형식으로 요청하세요.

  • MySQL/MariaDB 소스: mysqldump --single-transaction --routines [DB이름] > backup.sql
  • PostgreSQL 소스: pg_dump --no-owner --no-privileges [DB이름] > backup.sql
  • 압축 전송: 파일이 크면 gzip backup.sql 로 .sql.gz 형식까지 만들어 받으면 업로드 시간이 줄어듭니다.

업로드 가능한 최대 크기는 1GB 입니다. 1GB가 넘는 경우 테이블을 나누어 덤프해 여러 파일로 만든 뒤 각각 업로드하세요.

Step 1. 데이터 패키지 탭 열기​

  1. 좌측 메뉴에서 [데이터베이스 관리] 를 선택합니다.
  2. 상단 탭에서 데이터 패키지 탭을 선택합니다.
  3. 탭 우측 상단에 SQL 파일 업로드 와 새로고침 두 개의 버튼이 보입니다.

Step 2. SQL 파일 업로드 버튼 클릭​

  1. 우측 상단의 SQL 파일 업로드 버튼을 클릭합니다.
  2. 운영체제의 파일 선택 창이 열립니다. .sql 또는 .sql.gz 파일을 고릅니다.
  3. 파일을 선택하면 별도 모달 없이 즉시 업로드가 시작됩니다. 적용 모드나 target DB를 고르는 단계는 이 시점에 없습니다.
업로드는 곧바로 적용이 아닙니다

SQL 파일 업로드 는 파일을 데이터 패키지 저장소에 보관만 합니다. 어떤 target DB에도 적용되지 않습니다. 적용은 업로드가 끝난 뒤 별도 단계에서 진행합니다.

Step 3. 업로드 완료 확인​

  1. 업로드가 끝나면 패키지 목록 상단에 새 행이 생깁니다.
  2. 새 패키지는 다음과 같이 등록됩니다.
    • 상태: ready (적용 가능한 준비 완료 상태)
    • 종류: import
    • 이름: 업로드한 파일명 (표시 이름)
  3. .sql.gz 로 올린 파일은 KIOPS가 자동으로 압축을 풀어 .sql 로 보관합니다.

Step 4. target DB에 적용하기​

업로드한 패키지를 실제 DB에 풀어 넣으려면 다음 두 경로 중 하나를 사용합니다.

  • 데이터 패키지 탭에서 적용: 패키지 행의 작업 컬럼에서 적용 버튼(번개 아이콘)을 눌러 PackageApplyModal을 엽니다. 여기서 target DB와 append/replace 모드를 고릅니다.
  • 마이그레이션 탭에서 적용: 마이그레이션 탭에서 "Source 형태"를 "보관된 데이터 패키지 (1회성 적용)"로 선택하면 보관된 패키지를 target에 적용할 수 있습니다.

자세한 적용 절차는 데이터 패키지 저장소 활용 가이드를 참고하세요.

replace 모드는 되돌릴 수 없습니다

적용 단계의 replace 모드는 대상 DB의 데이터를 모두 삭제한 뒤 덤프 내용으로 덮어씁니다. 운영 DB에 적용하기 전에는 반드시 [데이터베이스 관리] > 백업 관리 탭에서 백업을 만들거나, append 모드로 스테이징 환경에서 먼저 시험해 보세요.

자주 하는 실수​

자주 하는 실수: 업로드만 하고 적용이 끝났다고 생각함

SQL 파일 업로드 는 파일을 저장소에 보관만 하는 동작입니다. 패키지 상태가 ready 라는 것은 "적용 준비 완료"라는 뜻이지 "적용 완료"가 아닙니다. target DB에 실제로 반영하려면 데이터 패키지 저장소 활용 가이드의 적용 단계를 따로 진행해야 합니다.

자주 하는 실수: 1GB가 넘는 덤프를 그대로 올리려고 함

업로드 한도는 1GB 입니다. 그보다 큰 덤프는 테이블별로 잘라서 여러 파일로 만든 뒤 각각 업로드하세요.

자주 하는 실수: 마이그레이션 탭에서 업로드 버튼을 찾음

마이그레이션 탭에는 SQL 파일 업로드 버튼이 없습니다. 파일 업로드는 데이터 패키지 탭에서만 가능합니다. 마이그레이션 탭은 "등록된 DB 연결끼리의 스키마 비교" 또는 "보관된 데이터 패키지의 1회성 적용" 용도입니다.

응용 사례​

사례 A. 외부 협력 업체에서 받은 PostgreSQL 덤프를 KIOPS에 보관​

  1. .sql.gz 파일을 받은 직후 데이터 패키지 탭 > SQL 파일 업로드 클릭.
  2. 받은 파일을 선택하면 즉시 업로드되어 패키지 목록에 ready 상태로 등록됩니다.
  3. 이후 운영 PostgreSQL에 적용할 때는 패키지 행의 적용 버튼으로 PackageApplyModal을 엽니다.

사례 B. 같은 덤프를 여러 환경에 적용하기 위해 미리 보관​

  1. 데이터 패키지 탭에서 SQL 덤프 파일을 업로드해 둡니다.
  2. 한 번 보관한 패키지는 dev → staging → prod 순으로 적용 버튼을 반복해서 사용할 수 있습니다.
  3. 매번 파일을 다시 올릴 필요가 없습니다.

다음에 할 일​

관련 가이드​

  • 페이지 참조: [데이터베이스 관리] 페이지 가이드 (pages/database)
  • 운영 백업 흐름: 백업/복구 시나리오