본문으로 건너뛰기

데이터 패키지 저장소 활용

같은 SQL 덤프를 dev, staging, prod 환경에 차례로 적용해야 하거나, 외부에서 받은 덤프를 잠시 보관만 해 두고 싶다면 데이터 패키지 저장소를 사용합니다. 일상에 비유하면 업로드는 USB 를 책장에 꽂아두는 것, 적용은 책장의 USB 를 다른 컴퓨터에 풀어 넣는 것, 다운로드는 USB 를 다시 빼서 가져가는 것에 해당합니다.

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

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

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

사전 준비​

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

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

[데이터베이스 관리] 페이지의 상단 탭에서 데이터 패키지 탭을 선택하면 진입할 수 있습니다.

탭 위치는 권한에 따라 달라집니다

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

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

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

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

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

탭 우측 상단에는 버튼 2개가 있습니다.

  1. SQL 파일 업로드: 보유한 덤프 파일을 저장소에만 보관합니다 (즉시 적용 X).
  2. 새로고침: 목록을 최신 상태로 갱신합니다.

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

용량 한도와 자동 정리
  • 기관당 5GB 한도: 한 기관이 저장소에 보관할 수 있는 총 용량은 5GB 입니다. 업로드 시점에 한도가 초과되면 작업이 거부됩니다.
  • 30일 자동 정리: 자동 정리 대상은 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. PackageApplyModal 이 열립니다.
자주 하는 실수: applying / deleted 상태에서 적용을 시도

applying 상태는 다른 작업이 이미 진행 중이라는 뜻입니다. 끝날 때까지 기다리세요. 진행 상황은 같은 행의 상태 태그로 추적되며, 적용 중인 패키지가 있으면 목록이 자동으로 갱신됩니다. applying 과 deleted 상태에서는 적용 버튼이 비활성화되며, 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 순으로 진행하세요.

자주 하는 실수: 운영 환경에 replace 로 적용 후 실패

운영 DB 에 replace 적용이 실패하면 빈 테이블만 남는 상태가 될 수 있습니다. 운영 적용 전에는 반드시 [데이터베이스 관리] > 백업 관리 탭에서 백업을 먼저 만들고, 가능하면 staging 환경에서 같은 패키지로 한 번 더 사전 검증하세요.

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

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

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

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

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

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

applied 상태의 import 패키지는 적용 완료 후 30일이 지나면 자동 정리됩니다. 적용까지 끝낸 덤프를 장기 보존하려면 정리 전에 다운로드 로 로컬에 빼두세요. 같은 파일을 다시 업로드하면 새 패키지로 등록됩니다.

데이터 패키지 정리하기​

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

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

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

다음에 할 일​

관련 가이드​

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