Mac 환경에서 MySQL Workbench를 설치하고 데이터베이스에 연결하는 방법을 단계별로 정리한 가이드를 찾고 계신가요? 본 포스팅은 MacOS 사용자들을 위한 MySQL Workbench 설치 방법부터 DB 접속 오류 해결 팁까지 자세하게 설명한 글입니다. 특히, DB 접속 시 튕김 현상으로 불편함을 겪는 분들에게도 유용한 정보를 담고 있으니 끝까지 정독해 주세요.
1. MySQL Workbench란?
MySQL Workbench는 MySQL 데이터베이스를 설계, 개발, 관리할 수 있는 통합 환경을 제공하는 도구입니다. 직관적인 GUI를 제공하여 SQL 쿼리 실행, ERD 설계, 데이터베이스 마이그레이션 등 다양한 작업을 편리하게 수행할 수 있어, 개발자나 데이터베이스 관리자들에게 필수 도구로 손꼽힙니다.
Mac에서도 무료로 사용할 수 있으며, 설치 방법이 간단하지만 초보자에게는 설정 과정에서 몇 가지 헷갈리는 부분이 있을 수 있습니다. 지금부터 설치부터 설정, 그리고 자주 발생하는 오류까지 한 번에 해결해 보겠습니다.
2. MySQL Workbench 설치 파일 다운로드
✅ 공식 다운로드 사이트 접속
MySQL Workbench는 오라클(Oracle)에서 공식적으로 제공하고 있으며, 아래 사이트에서 안전하게 설치 파일을 다운로드할 수 있습니다.
👉 https://dev.mysql.com/downloads/workbench/
사이트에 접속하면 운영체제별 설치 파일 목록이 표시됩니다. Mac 사용자는 "macOS 64-bit" 버전을 선택하시면 됩니다.
💡 대부분의 최신 맥북은 64비트 기반이므로 별다른 설정 없이도 64비트 버전을 다운로드하시면 됩니다.
3. Mac이 64비트인지 확인하는 방법
터미널을 실행한 후 아래 명령어를 입력하면 현재 Mac 시스템이 64비트인지 확인할 수 있습니다.
uname -a
명령어를 입력했을 때 x86_64 또는 arm64와 같은 결과가 나오면 64비트 시스템입니다. Mac은 2007년 이후 대부분 64비트 기반으로 출시되었으므로, 최근 기기 사용자라면 걱정 없이 설치하시면 됩니다.
4. 다운로드 시 로그인 여부 안내
설치 파일을 다운로드하려고 하면 Oracle 계정 로그인 페이지로 전환될 수 있습니다. 이때 반드시 로그인할 필요는 없습니다.
페이지 하단에 있는 "No thanks, just start my download." 링크를 클릭하면 로그인을 건너뛰고 다운로드를 바로 시작할 수 있습니다.
5. MySQL Workbench 설치 방법
✅ 다운로드한 .dmg 파일 실행
다운로드가 완료되면 .dmg 확장자의 설치 파일을 실행합니다. 설치 마법사가 자동으로 실행되며, MySQL Workbench 아이콘이 표시된 창이 열립니다.
✅ 응용 프로그램 폴더로 드래그
MySQL Workbench 아이콘을 Applications(응용 프로그램) 폴더로 드래그하면 설치가 완료됩니다.
설치 중 문제가 발생한다면 맥의 보안 설정 또는 MacOS 버전을 확인해 보세요.
6. MySQL Workbench 실행 및 초기 설정
설치가 완료되면 응용 프로그램 폴더에서 MySQL Workbench를 찾아 실행합니다. 처음 실행 시 다음과 같은 보안 경고창이 표시될 수 있습니다.
확인되지 않은 개발자에 의해 열릴 수 있습니다.
이 경우, "열기" 버튼을 클릭하면 정상적으로 실행됩니다.
7. 데이터베이스 연결 설정 방법
✅ 새 연결 추가
MySQL Workbench 메인 화면에서 "MySQL Connections" 영역 오른쪽에 있는 "+" 버튼을 클릭하여 새로운 데이터베이스 연결을 설정합니다.
✅ 연결 정보 입력
아래 항목을 입력해야 합니다:
- Connection Name: 연결 이름 (예: Localhost)
- Hostname: 일반적으로 로컬에서는 127.0.0.1
- Port: 기본값 3306
- Username: 보통 root
- Password: Store in Keychain 버튼을 눌러 비밀번호 저장
입력이 완료되면 하단의 "Test Connection" 버튼을 클릭하여 정상적으로 연결되는지 테스트합니다. 연결이 성공적으로 이루어졌다면, **"OK"**를 눌러 연결 정보를 저장하세요.
8. 데이터베이스 접속 오류 해결 – 접속 시 튕김 현상
❗ 자주 발생하는 문제: 튕김 현상
MySQL Workbench를 실행하고 데이터베이스에 연결하려고 하면 튕기는 문제가 발생할 수 있습니다. 특히 다음 버전에서 이 문제가 빈번하게 보고되었습니다:
- 8.0.36
- 8.0.34
- 8.0.33
- 8.0.32
- 8.0.31
하지만 이 문제는 MySQL Workbench 자체 버전 문제보다는, 연결 대상 데이터베이스가 실행되고 있지 않을 때 발생하는 현상인 경우가 많습니다.
✅ 해결 방법
- MySQL 서버가 실행 중인지 확인
시스템 환경설정 또는 터미널에서 MySQL 서버 상태를 확인하고, 실행 중이 아니라면 수동으로 실행합니다. - sudo mysql.server start
- 포트 충돌 또는 방화벽 설정 확인
포트 3306이 막혀 있거나 충돌이 있는 경우도 튕김 현상이 발생할 수 있으니 네트워크 설정도 확인하세요.
9. 총평
Mac에서 MySQL Workbench를 설치하고 연결 설정까지 완료하는 과정은 비교적 간단하지만, 초보자에게는 몇 가지 주의할 점과 오류 대응 방법을 알아두는 것이 좋습니다. 특히, DB 접속 시 튕김 현상은 대부분 서버 실행 여부와 관련이 있으므로, 설치 후 반드시 MySQL 서버가 정상적으로 실행 중인지 확인해야 합니다.
✔ 설치 후 첫 연결 전에는 반드시 MySQL 서버를 켜주세요!
10. 관련 태그
#MySQLWorkbench #맥북MySQL설치 #MacMySQL #DB툴설치 #MySQLGUI #MacOSMySQL #MySQL접속오류 #DB관리도구
'정보' 카테고리의 다른 글
[윈도우에서 MySQL Workbench 데이터베이스 연결하는 법] 기본 연결부터 SSH 연결까지 완벽 가이드 (0) | 2025.05.09 |
---|---|
Mac에서 Python 3 다운로드 및 설치(Homebrew 사용) (0) | 2025.05.09 |
DBeaver 다크 모드 설정 방법 (Windows/Mac 공통) – 눈 편한 개발 환경 만들기 (0) | 2025.05.09 |
[Mac] Homebrew로 PostgreSQL 설치하고 DBeaver에서 연결하는 완벽 가이드 (0) | 2025.05.09 |
[Mac] DBeaver에서 SQL 포맷을 변경하는 방법 – 복잡한 한줄 쿼리도 깔끔하게 정리하자! (0) | 2025.05.09 |