MySQL은 전 세계적으로 가장 널리 사용되는 오픈소스 데이터베이스 시스템 중 하나입니다. 특히 개발자나 데이터 분석가들이 많이 사용하는 MySQL Workbench는 그래픽 기반의 사용자 인터페이스로 SQL 쿼리 실행, 데이터베이스 설계, 연결 관리 등 다양한 작업을 쉽게 수행할 수 있도록 도와줍니다.
오늘은 Windows 환경에서 MySQL Workbench를 이용해 데이터베이스에 연결하는 방법에 대해 알아보겠습니다. 기본적인 TCP/IP 연결 방식은 물론, 보안이 강화된 SSH 터널링을 통한 연결 방법까지 모두 설명드리니, 상황에 맞게 선택해서 사용하시면 좋겠습니다.
📌 목차
- MySQL Workbench란?
- MySQL Workbench 설치 방법 간략 안내
- 기본 연결 방법 (Standard TCP/IP)
- SSH 터널을 이용한 연결 방법 (Standard TCP/IP over SSH)
- 자주 묻는 질문 (FAQ)
- 마무리 및 팁
1. ✅ MySQL Workbench란?
MySQL Workbench는 MySQL 데이터베이스를 관리하고 설계할 수 있는 공식 툴입니다. 다음과 같은 기능들을 제공합니다:
- SQL 개발 (쿼리 작성 및 실행)
- 데이터베이스 설계 및 모델링
- 서버 설정 및 모니터링
- 사용자 계정 관리
- 백업 및 복원
특히 GUI 기반으로 쉽게 사용할 수 있는 점과 다양한 접속 옵션을 지원하는 점이 장점이며, 오늘 소개할 연결 기능 역시 Workbench를 선택해야 하는 중요한 이유 중 하나입니다.
2. 🛠 MySQL Workbench 설치 방법 (간략 안내)
MySQL Workbench를 아직 설치하지 않으셨다면 다음의 단계를 참고해 주세요:
- MySQL 공식 홈페이지 접속
- Windows용 MySQL Workbench 다운로드
- 설치 파일 실행 후 기본 설정으로 설치 진행
설치 완료 후 바탕화면 또는 시작 메뉴에서 MySQL Workbench를 실행하면 바로 연결 설정이 가능합니다.
3. 🔌 기본 연결 방법 (Standard TCP/IP)
3-1. 새로운 연결 추가
MySQL Workbench를 실행하면 메인 화면에서 MySQL Connections라는 섹션이 보입니다. 이 영역 오른쪽의 + 버튼을 클릭하면 새로운 연결을 추가할 수 있는 창이 열립니다.
3-2. 연결 설정 입력
아래의 항목들을 하나씩 입력합니다:
항목 설명
| Connection Name | 연결에 대한 이름입니다. 예: MyDB_Test |
| Connection Method | 기본값인 Standard (TCP/IP) 그대로 사용 |
| Hostname | 연결하려는 데이터베이스 서버의 IP 주소 또는 도메인 |
| Port | MySQL 기본 포트인 3306을 사용하거나, 서버 설정에 맞게 변경 |
| Username | MySQL 계정 아이디 (예: root) |
| Password | 계정 비밀번호. Store in Vault 버튼을 눌러 입력 |
| Default Schema | 선택 사항. 접속 시 자동으로 선택할 데이터베이스 이름 |
3-3. 연결 테스트
모든 입력이 완료되면 하단의 Test Connection 버튼을 클릭합니다. 다음과 같은 메시지가 나타납니다:
- ✅ Success: 연결 성공
- ❌ Error: 연결 오류 (Hostname, Port, Username, Password 확인 필요)
정상적으로 연결이 되었으면 OK 버튼을 눌러 저장하고, 메인 화면에서 해당 연결을 더블 클릭하면 DB에 접속됩니다.
4. 🔐 SSH 터널을 이용한 연결 방법 (Standard TCP/IP over SSH)
보안이 중요한 환경에서는 SSH 터널링을 이용한 연결 방식이 자주 사용됩니다. 이 방식은 중간에 SSH 서버를 통해 MySQL 서버에 접속함으로써 암호화된 통신이 가능합니다.
4-1. SSH 연결 방식 선택
새 연결 추가 화면에서 다음을 설정합니다:
- Connection Method: Standard TCP/IP over SSH 선택
4-2. SSH 정보 입력
항목 설명
| SSH Hostname | SSH 서버 주소 (예: 123.456.78.90 또는 도메인) |
| SSH Username | SSH 접속 계정 |
| SSH Password 또는 SSH Key File | 비밀번호 직접 입력 또는 키 파일 사용 (pem, ppk 등) |
💡 SSH Key File을 사용하는 경우, AWS나 리눅스 서버에서 제공받은 *.pem 파일이나 PuTTY에서 변환한 *.ppk 파일을 사용하면 됩니다.
4-3. MySQL 정보 입력
SSH 아래쪽에 있는 MySQL 관련 입력값은 기본 연결과 동일하게 설정합니다:
- MySQL Hostname: 일반적으로 127.0.0.1 (SSH 서버 기준 내부 주소)
- Port: 보통 3306
- Username: DB 접속 계정
- Password: Store in Vault 버튼으로 입력
- Default Schema: 선택 사항
4-4. 연결 테스트
모든 항목을 입력한 후 Test Connection을 눌러 확인합니다. Success 메시지가 뜨면 설정을 저장하고 연결을 시작할 수 있습니다.
5. ❓ 자주 묻는 질문 (FAQ)
Q1. 연결이 안 될 때는 어떤 부분을 확인해야 하나요?
- IP 주소와 포트 번호가 올바른지 확인
- 방화벽 설정이나 보안 그룹에서 포트 3306이 열려 있는지 확인
- SSH 접속 정보 (키 파일 또는 비밀번호) 정확성 확인
Q2. Workbench에서 저장한 비밀번호를 잊어버렸어요.
- Windows Credential Manager에서 해당 항목을 삭제 후, 다시 연결 생성 시 새 비밀번호 입력
Q3. SSH Key 파일은 어떻게 변환하나요?
- .pem → .ppk: PuTTYgen 도구 사용
- PuTTYgen 실행 → Load → .pem 선택 → Save private key
6. 📝 마무리 및 팁
MySQL Workbench는 매우 강력하면서도 직관적인 툴입니다. 특히 다양한 연결 방식 지원으로 로컬 개발 환경부터 클라우드 서버까지 쉽게 연동할 수 있다는 점이 큰 장점이죠.
연결 설정을 잘해두면 이후 쿼리 작업, 데이터베이스 구조 확인, 백업 및 복원 작업 등을 훨씬 수월하게 할 수 있습니다. 만약 여러 서버에 접근해야 한다면 연결 이름을 명확하게 구분하여 설정하고, SSH 터널링을 통해 보안을 강화하는 습관을 들이시길 추천드립니다.
🔖 관련 태그
#MySQLWorkbench #데이터베이스연결 #MySQL연결방법 #SSH연결 #윈도우MySQL #SQL툴 #MySQL보안접속 #DB관리툴
'정보' 카테고리의 다른 글
| [Windows/Java] STS(Spring Tool Suite)에서 Lombok 설치 및 연동 완벽 가이드 (0) | 2025.05.09 |
|---|---|
| [완벽 가이드] Windows에서 MySQL Workbench로 DDL 쿼리 추출하는 방법 – 테이블 생성문 확인부터 복사까지 (0) | 2025.05.09 |
| Mac에서 Python 3 다운로드 및 설치(Homebrew 사용) (0) | 2025.05.09 |
| [Mac] MySQL Workbench 다운로드 및 설치 방법 (DB 접속 팁 포함) (0) | 2025.05.09 |
| DBeaver 다크 모드 설정 방법 (Windows/Mac 공통) – 눈 편한 개발 환경 만들기 (0) | 2025.05.09 |