본문으로 건너뛰기

데이터베이스 관리 시나리오

KIWI에서 데이터베이스 연결, 동기화 작업, 마이그레이션을 설정하는 방법을 안내합니다.

지원 데이터베이스​

데이터베이스버전동기화 지원마이그레이션 지원
MySQL5.7+OO
MariaDB10.3+OO
PostgreSQL12+OO
Oracle12c+OO

시나리오 1: 데이터베이스 연결 등록하기​

Q. 운영 중인 데이터베이스를 KIWI에 등록하고 싶습니다​

단계별 안내:

Step 1: 데이터베이스 관리 페이지 이동​

  • 이동 경로: [데이터베이스 관리]
  • UI 요소: 좌측 메뉴에서 "데이터베이스 관리" 클릭

Step 2: 새 연결 추가​

  • UI 요소: DB연결추가버튼 - "연결 추가" 버튼 클릭
  • 동작: 데이터베이스 연결 설정 모달이 열립니다

Step 3: 데이터베이스 유형 선택​

  • 선택: MySQL, MariaDB, PostgreSQL, Oracle 중 선택

Step 4: 연결 정보 입력​

  • 필수 입력 항목:
    항목설명예시
    연결 이름식별 가능한 이름production-mysql
    호스트DB 서버 주소db.company.com
    포트DB 포트3306
    데이터베이스명연결할 DBmyapp
    사용자명DB 계정admin
    비밀번호DB 비밀번호********

Step 5: 고급 설정 (선택사항)​

  • 옵션:
    항목설명
    SSL 사용암호화 연결
    SSH 터널SSH를 통한 접근
    연결 풀 크기동시 연결 수
    타임아웃연결 제한 시간

Step 6: 연결 테스트 및 저장​

  • UI 요소: 연결테스트버튼 - "연결 테스트" 버튼 클릭
  • 확인: 연결 성공 메시지 확인 후 "저장"
  • 결과: DB연결목록테이블에 새 연결이 추가됩니다

시나리오 2: 데이터베이스 동기화 작업 설정하기​

Q. 두 데이터베이스 간 데이터를 동기화하고 싶습니다​

사전 조건: 소스와 대상 데이터베이스가 모두 등록되어 있어야 합니다.

단계별 안내:

Step 1: 데이터베이스 관리 페이지 이동​

  • 이동 경로: [데이터베이스 관리]

Step 2: 동기화 탭 선택​

  • UI 요소: 동기화탭 - 상단 탭에서 "동기화" 클릭

Step 3: 새 동기화 작업 생성​

  • UI 요소: 동기화작업추가버튼 - "동기화 작업 추가" 버튼 클릭

Step 4: 소스 및 대상 설정​

  • 입력 항목:
    항목설명
    작업 이름동기화 작업 식별 이름
    소스 DB데이터를 가져올 데이터베이스
    대상 DB데이터를 저장할 데이터베이스
    동기화 방향단방향 / 양방향

Step 5: 동기화 대상 테이블 선택​

  • UI 요소: 테이블선택체크박스 - 동기화할 테이블 선택
  • 옵션:
    모드설명
    전체 테이블모든 테이블 동기화
    선택 테이블특정 테이블만 동기화
    제외 테이블특정 테이블 제외

Step 6: 동기화 옵션 설정​

  • 입력 항목:
    항목설명기본값
    충돌 처리데이터 충돌 시 동작소스 우선
    삭제 동기화소스에서 삭제된 데이터 처리유지
    배치 크기한 번에 처리할 레코드 수1000

Step 7: 스케줄 설정 (선택사항)​

  • 옵션:
    주기설명
    수동수동으로만 실행
    실시간CDC(Change Data Capture) 기반
    정기cron 스케줄 기반

Step 8: 저장 및 실행​

  • UI 요소: "저장" 버튼 클릭
  • 동작: "지금 실행" 버튼으로 즉시 동기화 가능

시나리오 3: 데이터베이스 마이그레이션 실행하기​

Q. 데이터베이스 스키마와 데이터를 새 서버로 이관하고 싶습니다​

단계별 안내:

Step 1: 데이터베이스 관리 페이지 이동​

  • 이동 경로: [데이터베이스 관리]

Step 2: 마이그레이션 탭 선택​

  • UI 요소: 마이그레이션탭 - 상단 탭에서 "마이그레이션" 클릭

Step 3: 새 마이그레이션 생성​

  • UI 요소: 마이그레이션생성버튼 - "마이그레이션 생성" 버튼 클릭

Step 4: 마이그레이션 유형 선택​

  • 유형:
    유형설명사용 시점
    스키마만DDL만 이관개발 환경 복제
    데이터만데이터만 이관스키마 이미 존재 시
    전체스키마 + 데이터완전한 복제

Step 5: 소스/대상 설정​

  • 입력 항목:
    항목설명
    소스 DB원본 데이터베이스
    대상 DB이관 대상 데이터베이스
    대상 스키마대상 DB의 스키마명 (선택)

Step 6: 마이그레이션 옵션 설정​

  • 옵션:
    항목설명
    외래키 검사마이그레이션 중 FK 검사 비활성화
    인덱스 재생성마이그레이션 후 인덱스 재생성
    트리거 포함트리거/프로시저 포함 여부
    병렬 처리동시 처리 스레드 수

Step 7: 마이그레이션 미리보기​

  • UI 요소: 마이그레이션미리보기 - "미리보기" 버튼 클릭
  • 확인 사항:
    • 이관될 테이블 목록
    • 예상 데이터 크기
    • 예상 소요 시간

Step 8: 마이그레이션 실행​

  • UI 요소: "마이그레이션 시작" 버튼 클릭
  • 모니터링: 진행률 및 로그 실시간 확인

시나리오 4: 데이터베이스 모니터링 확인하기​

Q. 등록된 데이터베이스의 상태를 모니터링하고 싶습니다​

단계별 안내:

Step 1: 데이터베이스 관리 페이지 이동​

  • 이동 경로: [데이터베이스 관리]

Step 2: 연결 상태 확인​

  • UI 요소: DB연결목록테이블 - 연결 상태 컬럼 확인
  • 상태 표시:
    상태의미
    연결됨정상 연결 상태
    연결 끊김연결 실패
    대기 중연결 시도 중

Step 3: 상세 모니터링 보기​

  • 동작: 연결 항목 클릭하여 상세 정보 확인
  • 정보 포함:
    • 연결 풀 상태
    • 쿼리 실행 통계
    • 마지막 활동 시간

시나리오 5: SSH 터널을 통한 데이터베이스 연결​

Q. 방화벽 뒤에 있는 데이터베이스에 접근하고 싶습니다​

사전 조건: SSH 접근이 가능한 서버가 **[장비 관리]**에 등록되어 있어야 합니다.

단계별 안내:

Step 1: 데이터베이스 연결 추가​

  • 이동 경로: [데이터베이스 관리] → "연결 추가"

Step 2: SSH 터널 활성화​

  • UI 요소: SSH터널사용 체크박스 선택

Step 3: SSH 설정 입력​

  • 입력 항목:
    항목설명예시
    SSH 호스트터널링 서버gateway.company.com
    SSH 포트SSH 포트22
    SSH 사용자SSH 계정admin
    SSH 인증비밀번호/키SSH 키 권장
    로컬 포트터널 포트13306 (자동 할당)

Step 4: 데이터베이스 연결 정보 입력​

  • 주의: DB 호스트는 SSH 서버 기준 내부 주소 사용
  • 예시: localhost 또는 192.168.x.x

Step 5: 연결 테스트 및 저장​

  • 확인: SSH 터널 + DB 연결 모두 성공해야 함

관련 질문​

자주 묻는 질문​

질문답변관련 페이지
데이터베이스 연결이 실패합니다호스트, 포트, 인증 정보 확인[데이터베이스 관리]
동기화가 느립니다배치 크기 조정 및 인덱스 확인[데이터베이스 관리]
마이그레이션 중 오류가 발생합니다외래키 순서 및 데이터 타입 호환성 확인[데이터베이스 관리]
SSL 연결이 안 됩니다인증서 설정 및 DB 서버 SSL 설정 확인[데이터베이스 관리]

다음 단계​

데이터베이스 설정이 완료되면 다음 작업을 진행하세요:

  • 정기 동기화 스케줄 설정
  • 동기화 작업 모니터링 알림 구성
  • 마이그레이션 전 데이터 백업 확인