본문으로 건너뛰기

데이터 패키지 저장소 활용

같은 SQL 덤프를 dev, staging, prod 환경에 차례로 적용해야 하거나, 외부에서 받은 덤프를 잠시 보관만 해 두고 싶다면 데이터 패키지 저장소를 사용합니다. 업로드는 덤프 파일을 KIOPS에 보관하는 것, 적용은 보관한 덤프를 target DB 에 넣는 것, 다운로드는 보관본을 로컬로 다시 받는 것입니다.

이 가이드는 데이터 패키지 탭의 사용 시나리오 세 가지를 순서대로 따라할 수 있게 정리합니다.

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

  • 데이터 패키지: KIOPS 안에 보관해 둔 SQL 덤프 묶음입니다. 업로드 시점·적용 이력·DB 타입을 함께 보관합니다.
  • import 종류: 보유한 SQL 덤프 파일을 업로드해 등록한 패키지입니다.
  • export 종류: KIOPS 가 직접 source DB 를 떠서 만든 패키지입니다 (해당 기능 활성화 시).
  • 상태 태그: 패키지의 현재 상태입니다. ready / applying / applied / failed / deleted 다섯 가지가 있습니다.
  • 패키지 적용 모달: 저장된 패키지를 선택해 target DB 에 다시 적용할 때 열리는 창입니다.
  • 5GB 한도 / 30일 자동 정리: 데이터 패키지에 적용되는 운영 한계입니다. 자세한 내용은 사전 준비 단락을 보세요.

사전 준비​

시작 전 다음이 준비돼 있어야 합니다.

  • 데이터베이스 관리 권한이 있어야 데이터 패키지 탭이 보입니다.
  • 패키지를 적용하려면 target DB 가 DB 연결 탭에 등록되어 있고, target / SSH / Jump 비밀번호를 미리 알고 있어야 합니다.
  • 업로드 시점에 기관 저장소가 5GB 한도 안에 있어야 합니다. 한도가 차 있으면 업로드와 자동 보관이 거부됩니다.

데이터 패키지 탭의 위치와 구성​

[데이터베이스 관리] 페이지의 상단 탭에서 데이터 패키지 탭을 선택하면 진입할 수 있습니다. 탭은 DB 연결, 동기화 작업, 마이그레이션, 백업 관리, 데이터 패키지, 실행 이력 순으로 나열되지만 동기화 작업·마이그레이션 탭은 권한에 따라 숨겨질 수 있으므로, "몇 번째 탭"으로 찾지 말고 데이터 패키지 라벨을 직접 찾으세요.

목록 테이블은 다음 컬럼으로 구성됩니다.

컬럼설명
이름표시 이름 (업로드 시 지정하지 않으면 파일명) + 파일명
DB 타입PostgreSQL / MySQL / MariaDB
크기파일 크기
상태ready / applying / applied / failed / deleted
생성일패키지 등록 일시
작업적용 / 다운로드 / 삭제 액션 버튼

참고: 패키지에는 import/export 구분(package_type) 값이 내부적으로 저장되지만, 목록 테이블에는 별도 '종류' 컬럼으로 표시되지 않습니다.

상태 태그는 색상으로 구분됩니다.

  • ready (회색) - 적용 가능한 준비 완료 상태
  • applying (파랑) - 현재 어떤 target DB 에 적용 중
  • applied (파랑) - 적용에 성공한 상태
  • failed (빨강) - 적용 중 오류 발생
  • deleted (회색) - 삭제 처리된 항목

탭 우측 상단에는 SQL 파일 업로드 버튼이 있습니다. 보유한 덤프 파일을 저장소에 보관하기만 하며, target DB 에 곧바로 적용하지는 않습니다. 목록은 별도 새로고침 버튼 없이 자동으로 갱신됩니다 — 탭 진입 시 로드되고, '적용 중' 상태인 패키지가 있으면 5초 간격으로 자동 갱신됩니다.

각 패키지 행의 작업 컬럼에는 적용 / 다운로드 / 삭제 3개의 액션 버튼이 있습니다.

용량 한도와 자동 정리 — 한 기관이 저장소에 보관할 수 있는 총 용량은 5GB이며, 업로드 시점에 한도가 초과되면 작업이 거부됩니다. 또한 applied 상태이면서 종류가 import 인 패키지는 적용 완료 후 30일이 지나면 파일과 목록 항목이 자동으로 정리됩니다(ready 상태로 보관만 한 패키지는 대상이 아님). 장기 보존이 필요하면 다운로드 로 로컬에 빼내 두세요.

시나리오 1. 외부에서 받은 덤프 보관만 하기​

당장 적용할 필요는 없지만 나중에 쓸 가능성이 있는 덤프를 KIOPS 에 올려두는 흐름입니다.

Step 1. 패키지 탭 진입​

  1. [데이터베이스 관리] > 데이터 패키지 탭으로 이동합니다.
  2. 우측 상단의 SQL 파일 업로드 버튼(업로드 아이콘)을 클릭합니다.

Step 2. 파일 선택과 업로드​

  1. .sql 또는 .sql.gz 파일을 선택합니다 (1GB 한도).
  2. 업로드가 완료되면 목록 상단에 새 패키지 행이 생기고 상태가 ready 로 표시됩니다.
  3. 종류는 자동으로 import 로 분류되고, 표시 이름에는 업로드한 파일명이 들어갑니다.

이 시점에는 어떤 target DB 에도 적용되지 않은 "그저 보관 중" 인 상태입니다. 필요할 때 시나리오 2 로 진행합니다.

시나리오 2. 여러 환경에 같은 덤프 적용하기​

한 번 등록한 패키지를 dev → staging → prod 처럼 차례로 적용하는 흐름입니다. 매번 파일을 다시 올릴 필요가 없어집니다.

Step 1. 적용 모달 열기​

  1. 데이터 패키지 탭에서 적용할 패키지 행을 찾습니다.
  2. 작업 컬럼의 적용 버튼(번개 아이콘)을 클릭합니다.
  3. 패키지 적용 모달이 열립니다.

applying 상태의 패키지는 적용 버튼이 비활성화되어 있으니(다른 작업 진행 중), 상태 태그로 진행을 확인하며 끝날 때까지 기다립니다. deleted 상태에서는 적용·다운로드가 모두 불가합니다.

Step 2. Target DB 와 적용 모드 선택​

  1. Target DB: 이번에 풀어 넣을 환경의 DB 연결을 선택합니다 (dev / staging / prod 중 하나).
  2. 적용 모드:
    • 신규 임포트 (append) (기본값): 기존 데이터에 덧붙입니다.
    • 전체 초기화 후 임포트 (replace): 대상의 모든 테이블/데이터를 삭제한 뒤 채웁니다. 위험하므로 사용자가 명시적으로 선택해야 하며, 선택 시 사전 백업 옵션이 자동으로 켜진 채 고정되고, 적용 시 데이터 손실 위험을 확인하는 이중 확인(체크박스 + "위험을 감수하고 적용") 절차가 뜹니다.

Step 3. 비밀번호 입력과 시작​

  1. target DB / SSH / Jump 비밀번호를 입력합니다.
  2. 적용 시작 을 클릭하면 모달이 닫히고 백그라운드 작업이 시작됩니다.
  3. 패키지 행의 상태가 applying (파랑) 으로 바뀌고, 완료 후 applied (파랑) 또는 failed (빨강) 로 갱신됩니다.

Step 4. 다음 환경에 반복 적용​

applied 상태가 된 패키지는 다시 적용 이 가능합니다. 같은 행에서 적용 버튼을 다시 클릭하여 staging → prod 순으로 진행하세요.

시나리오 3. 패키지를 외부로 가져가기 (다운로드)​

KIOPS 에 보관한 덤프를 로컬 PC 로 빼서 다른 환경(외부 서버, 백업 디스크 등)으로 옮기는 흐름입니다.

Step 1. 다운로드 버튼 클릭​

  1. 데이터 패키지 탭에서 가져갈 패키지 행을 찾습니다.
  2. 작업 컬럼의 다운로드 버튼(다운로드 아이콘)을 클릭합니다.
  3. 브라우저가 보관된 .sql 파일 다운로드를 시작합니다. .sql.gz 로 업로드한 파일도 KIOPS가 압축을 풀어 .sql 로 보관하므로 다운로드 시에는 평문 .sql 로 받습니다.

Step 2. 외부 보관 또는 이관​

  • 받은 파일은 외부 백업 시스템, 다른 KIOPS 인스턴스, 또는 협력사로 그대로 전달할 수 있습니다.
  • 다른 KIOPS 인스턴스로 옮길 경우 받는 쪽 인스턴스의 데이터 패키지 탭에서 다시 업로드하면 같은 덤프를 사용할 수 있습니다.

데이터 패키지 정리하기​

업로드한 패키지가 더 이상 필요 없으면 직접 삭제할 수 있습니다.

  1. 삭제할 패키지 행의 삭제 버튼(삭제 아이콘)을 클릭합니다.
  2. 확인 팝업이 표시되면 동의합니다.
  3. 패키지 상태가 deleted 로 바뀌고 적용·다운로드 액션이 비활성화됩니다.

자동 정리는 applied 상태의 import 패키지만 대상으로 하므로, 보관만 한 ready 패키지나 불필요해진 패키지는 직접 삭제해 기관 저장소의 5GB 한도를 효율적으로 사용하세요.

자주 하는 실수​

  • applying / deleted 상태에서 적용 시도: applying 은 다른 작업이 진행 중이라는 뜻이니 끝날 때까지 기다립니다. deleted 상태에서는 적용·다운로드가 비활성화됩니다.
  • 운영 환경에 replace 로 적용 후 실패: 운영 DB 에 replace 적용이 실패하면 빈 테이블만 남을 수 있습니다. 운영 적용 전에는 반드시 백업 관리 탭에서 백업을 먼저 만들고, 가능하면 staging 에서 같은 패키지로 사전 검증하세요.
  • 보관해 둔 패키지가 목록에서 사라짐: applied 상태의 import 패키지는 적용 완료 후 30일이 지나면 자동 정리됩니다. 장기 보존하려면 정리 전에 다운로드 로 로컬에 빼두세요(같은 파일을 다시 업로드하면 새 패키지로 등록됩니다).

다음에 할 일​

관련 가이드​