본문으로 건너뛰기

데이터베이스 관리

KIOPS의 [데이터베이스 관리] 페이지에는 단순한 연결 등록·동기화 외에도 보유한 SQL 덤프 파일을 저장소에 보관하거나, 보관한 덤프를 여러 환경에 반복 적용할 수 있는 작업 흐름이 들어 있습니다.

이 카테고리의 가이드는 "기능이 어디에 있나" 가 아니라 "실제로 어떤 순서로 클릭해야 하나" 에 초점을 맞춥니다. 페이지 단위 참조는 [데이터베이스 관리] 페이지 가이드(pages/database)를 보세요. 이 카테고리는 일을 해야 하는 운영자가 처음부터 끝까지 따라할 수 있는 시나리오만 모았습니다.

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

이 카테고리에서 자주 나오는 용어를 짧게 정리합니다. 본문에서 처음 등장할 때 이 사전을 참고하세요.

  • SQL 덤프: DB의 구조(스키마)와 데이터를 한 덩어리의 SQL 명령으로 풀어 적은 파일입니다. mysqldump 또는 pg_dump 명령으로 만들며, USB에 옮겨 다닐 수 있는 "DB의 사진"이라고 보면 편합니다.
  • target DB: 덤프를 적용할 목적지 DB입니다. KIOPS의 DB 연결 탭에 등록된 연결 중에서 고릅니다.
  • 데이터 패키지: KIOPS 안에 보관해 둔 SQL 덤프 파일 묶음입니다. 한 번 업로드하면 다른 환경에 다시 풀 수 있는 "책장의 USB" 같은 개념입니다.
  • append / replace: 덤프 적용 모드입니다. append는 기존 데이터에 덧붙이고, replace는 대상 스키마를 비운 뒤 채워 넣습니다.
  • 상태 태그: 패키지의 현재 상태입니다. ready / applying / applied / failed / deleted 다섯 가지가 있으며, 적용 진행 상황은 데이터 패키지 탭의 상태 태그로 추적합니다.

사전 준비​

데이터베이스 관리 권한이 필요합니다

이 카테고리의 작업은 모두 [데이터베이스 관리] 페이지에서 시작합니다. 페이지 자체가 보이지 않는다면 기관 관리자에게 데이터베이스 관리 권한을 요청하세요.

작업 전에 다음 항목이 준비되어 있는지 확인하세요.

  1. DB 연결 등록 완료: 적용할 target DB가 [데이터베이스 관리] > DB 연결 탭에 등록되어 있고, 연결 테스트가 성공한 상태여야 합니다.
  2. target DB 접속 비밀번호: 적용 시 모달에서 별도로 한 번 더 입력해야 합니다 (SSH/Jump 비밀번호 포함).
  3. 보유한 SQL 덤프 파일: 직접 만들었거나 전달받은 .sql / .sql.gz 파일이 있어야 합니다.
  4. 저장소 여유 확인: 패키지로 보관하려면 기관 저장소가 5GB 한도 안에 있어야 합니다.

시나리오 목록​

KIOPS에서 SQL 덤프를 다루는 작업은 크게 세 가지 흐름으로 나뉩니다. 자신의 상황에 맞는 가이드를 선택해 따라가세요.

1. SQL 덤프 파일 업로드​

직접 만들었거나 전달받은 SQL 덤프(.sql / .sql.gz)를 [데이터베이스 관리] > 데이터 패키지 탭의 SQL 파일 업로드 버튼으로 저장소에 보관합니다.

  • 파일을 고르면 모달 없이 즉시 업로드되어 데이터 패키지로 등록됩니다.
  • 최대 1GB까지 업로드 가능합니다.
  • 적용은 업로드 후 별도 단계(패키지 적용)에서 진행합니다.

2. 데이터 패키지 저장소 활용​

업로드한 덤프를 KIOPS 안에 보관해 두고, 여러 환경(dev / staging / prod)에 차례로 적용하거나 다운로드해 외부로 가져갑니다.

  • 한 번 등록한 덤프를 재사용해야 할 때 사용합니다.
  • 적용은 패키지 행의 적용 버튼(PackageApplyModal) 또는 마이그레이션 탭의 패키지 적용 경로를 사용합니다.
  • 기관당 5GB 한도가 적용되고, 적용 완료된 import 패키지는 30일 후 자동 정리됩니다.

3. DB 종류가 다를 때의 주의사항​

MySQL/MariaDB 와 PostgreSQL 은 SQL 문법이 호환되지 않습니다.

  • 같은 엔진끼리만(MySQL ↔ MariaDB 포함) 변환 없이 적용할 수 있습니다.
  • 패키지 적용 화면은 엔진이 다른 조합을 차단합니다.
  • 백엔드에는 엔진 간 변환 로직이 있지만 현재 UI에서는 노출되지 않습니다.
운영 DB는 항상 백업 후 적용

이 카테고리의 작업은 대상 DB의 테이블을 비우거나 덮어쓰는 동작을 포함합니다. 운영 DB에 적용하기 전에는 반드시 [데이터베이스 관리] > 백업 관리 탭에서 백업을 먼저 만들거나, 스테이징 환경에서 충분히 검증한 뒤 진행하세요.

다음에 할 일​

세 가이드를 한 번씩 훑어본 뒤에는 다음 순서로 정착시키는 것을 권장합니다.

  1. SQL 덤프 파일 업로드 - 보유한 덤프를 데이터 패키지로 등록하는 단순한 업로드 흐름부터 익힙니다.
  2. 데이터 패키지 저장소 활용 - 보관한 덤프를 dev/staging/prod에 반복 적용하는 흐름으로 확장합니다.
  3. DB 종류가 다를 때의 주의사항 - DB 종류가 다른 환경 사이에서 발생하는 호환성 제약을 숙지합니다.

관련 가이드​