AWS RDS MySQL와 카카오클라우드 MySQL 간 데이터 마이그레이션

1. 전체 진행 흐름 및 사전 준비사항

Step 1) AWS RDS MySQL에 테스트 데이터 생성
Step 2) MySQL Workbench Migration Wizard를 이용한 데이터 이관
Step 3) Bastion VM에서 카카오클라우드 MySQL 접속 및 데이터 검증

AWS RDS MySQL (us-east-1)
        │
        │  MySQL Workbench Migration
        ▼
KakaoCloud MySQL (kr-central-2)
        ▲
        │  MySQL Client (검증)
Bastion VM

사전 준비 사항
AWS 계정 및 RDS MySQL 인스턴스
카카오클라우드 MySQL 인스턴스
Bastion VM (네트워크 접근 및 검증용)
MySQL Workbench 설치 환경 (Windows 기준 설명)

 

2. 마이그레이션 테스트용 데이터 생성 (AWS RDS)

MySQL Workbench를 이용해 AWS RDS MySQL에 접속한 후,
마이그레이션 테스트용 데이터베이스와 테이블을 생성한다.

1. AWS RDS MySQL 접속

MySQL Workbench에서 AWS RDS MySQL 엔드포인트로 연결한다.

- Hostname: {AWS_RDS_ENDPOINT}

- Port: 3306

- Username / Password: RDS 생성 시 설정한 계정

 

2. 테스트 데이터 생성 SQL 실행

-- 데이터베이스 생성
CREATE DATABASE library;

-- 데이터베이스 선택
USE library;

-- 테이블 생성
CREATE TABLE book (
  id INT NOT NULL,
  title VARCHAR(100),
  author VARCHAR(50),
  PRIMARY KEY (id)
);

-- 예제 데이터 삽입
INSERT INTO book (id, title, author) VALUES
(1, 'The Great Gatsby', 'F. Scott Fitzgerald'),
(2, 'To Kill a Mockingbird', 'Harper Lee'),
(3, '1984', 'George Orwell');

 

 

 

3. MySQL Workbench Migration Wizard 실행

1. Migration Wizard 진입
MySQL Workbench 상단 메뉴에서 다음 경로로 이동한다.
Database > Migration Wizard

2. Source Database 설정
Source RDBMS: MySQL
AWS RDS MySQL 접속 정보 입력 후 Test Connection으로 연결 확인

Hostname : {AWS_RDS_ENDPOINT}
Port     : 3306
Username : {USER}
Password : {PASSWORD}

연결이 확인되면 [Next] 를 클릭한다.

3. 마이그레이션 대상 스키마 선택
Select the schema to migrate 단계에서 library 스키마를 선택한다.
library 스키마가 보이지 않는 경우, 사전에 테스트 데이터 생성이 정상적으로 완료되었는지 확인한다.

4. Target Database 설정
Target RDBMS: MySQL
카카오클라우드 MySQL 연결 정보 선택
Source와 Target이 동일 서버/동일 스키마로 인식될 경우
Target 스키마 이름을 변경하거나 연결 정보를 다시 확인한다.

5. 마이그레이션 실행
다음 단계들은 기본 옵션 그대로 진행한다.
Object Migration / Data Transfer / Bulk Data Transfer

6. Migration 결과 확인
Migration Report에서 아래 항목을 확인한다.
Migrated schema: library
Migrated table: book
Data copy 결과: Succeeded (3/3 rows)
문제가 없다면 [Finish] 를 클릭하여 마이그레이션을 완료한다.

 

4. Bastion VM에서 카카오클라우드 MySQL 데이터 검증

Migration Wizard 완료 후,
실제 카카오클라우드 MySQL에 데이터가 정상 반영되었는지 확인한다.

 

1. Bastion VM에서 MySQL 접속

mysql --user={USER} --password={USER_PASSWORD} \
      --host {KAKAOCLOUD_MYSQL_ENDPOINT} --port 3306

 

2. 데이터 정합성 확인

USE library;

SELECT * FROM book;

# 출력 예시
+----+------------------------+----------------------+
| id | title                  | author               |
+----+------------------------+----------------------+
|  1 | The Great Gatsby        | F. Scott Fitzgerald  |
|  2 | To Kill a Mockingbird   | Harper Lee           |
|  3 | 1984                   | George Orwell        |
+----+------------------------+----------------------+

 

AWS RDS에서 생성한 데이터가 카카오클라우드 MySQL에 동일하게 조회되어 마이그레이션이 성공한 것을 확인

 

5. 트러블슈팅 및 해결 내용

1. MySQL Workbench에서 RDS 접속 불가 (보안 그룹 이슈)

- 문제 상황
MySQL Workbench에서 AWS RDS MySQL로 접속 시
Test Connection 단계에서 연결 실패 발생

- 원인
AWS RDS에 적용된 보안 그룹에서
Workbench가 실행 중인 클라이언트 IP에 대한 3306 포트 인바운드 규칙이 열려 있지 않음

- 해결 방법

AWS 콘솔 > RDS > 보안 그룹 설정 확인

MySQL 포트(3306)에 대해 다음 인바운드 규칙 추가

소스: Workbench 실행 환경의 Public IP (또는 Bastion VM 보안 그룹)

규칙 적용 후 Test Connection 정상 성공 확인

 

2. Migration Wizard에서 Target Database 선택 불가

- 문제 상황
Migration Wizard 진행 중
Target Database 선택 단계에서 카카오클라우드 MySQL이 선택지에 표시되지 않음

- 원인
MySQL Workbench에 카카오클라우드 MySQL 연결 정보가 사전에 등록되어 있지 않음

- 해결 방법

MySQL Workbench 홈 화면에서 신규 MySQL Connection 생성

카카오클라우드 MySQL 엔드포인트, 계정 정보 등록

연결 테스트 성공 후 Migration Wizard에서 Target Connection으로 정상 선택 가능