Mac에서 MariaDB 설치 및 MySQL Workbench 연결 과정 정리

Mac 환경에서 MariaDB를 설치하고 MySQL Workbench와 연결하는 과정을 정리했습니다.
설치 및 연결 과정에서 발생한 문제와 해결 방법도 포함되어 있으니 참고하세요! 🚀

---

📌 1. Homebrew로 MariaDB 설치 및 실행 관리

🔹 Homebrew 설치 여부 확인

brew --version

• 버전 정보가 출력되면 Homebrew가 이미 설치된 상태.

• 설치되지 않았다면, 아래 명령어로 Homebrew 설치

  /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

🔹 MariaDB 설치

brew install mariadb

• 설치 완료 후 버전 확인

  mysql --version

  • 출력 예시:
    mysql Ver 15.1 Distrib 11.6.2-MariaDB, for osx10.16

🔹 MariaDB 실행 및 중지

• MariaDB 실행 (백그라운드 서비스로 실행)
  brew services start mariadb

• MariaDB 중지 (백그라운드 서비스 종료)
  brew services stop mariadb

• MariaDB 재시작
  brew services restart mariadb

• MariaDB 현재 상태 확인
  brew services list

  • started 상태이면 MariaDB가 실행 중
  • stopped 상태이면 MariaDB가 실행되지 않음

• MariaDB 일회성 실행 (백그라운드 실행 없이 터미널에서 직접 실행)
  mysql.server start

• MariaDB 일회성 종료
  mysql.server stop

---

📌 2. MariaDB 서버 실행 및 접속

🔹 MariaDB 접속 테스트

mysql -u root -p

• 비밀번호 입력 프롬프트가 뜨면 root 비밀번호가 설정되지 않은 상태일 가능성이 높음.
• Access Denied 오류 발생 시, sudo mysql -u root로 로그인 후 비밀번호 설정.

---

📌 3. root 계정 비밀번호 설정 및 로그인 문제 해결

🔹 비밀번호 없이 root 계정 로그인

sudo mysql -u root

🔹 현재 사용자 인증 방식 확인

SELECT user, host, plugin FROM mysql.user;

• root 계정이 auth_socket을 사용하고 있다면 비밀번호 로그인 불가능.

🔹 root 계정을 비밀번호 방식으로 변경

UPDATE mysql.user SET plugin = 'mysql_native_password' WHERE user = 'root';
FLUSH PRIVILEGES;

🔹 root 비밀번호 설정

ALTER USER 'root'@'localhost' IDENTIFIED BY 'newpassword';
FLUSH PRIVILEGES;

• newpassword를 원하는 비밀번호로 변경.

🔹 MariaDB 재시작 후 테스트

brew services restart mariadb
mysql -u root -p

• 설정한 비밀번호 입력 후 정상적으로 로그인되는지 확인.

---

📌 4. MySQL Workbench에서 MariaDB 연결

🔹 MariaDB가 실행 중인지 확인

brew services list

• mariadb가 started 상태인지 확인.

🔹 MySQL Workbench에서 새 연결 생성

1. MySQL Workbench 실행
2. 새 연결(Connection) 추가
   • + 버튼 클릭하여 새 연결 생성.
3. 연결 정보 입력
   • Connection Name: 원하는 이름 입력 (예: MariaDB Local)
   • Connection Method: Standard (TCP/IP)
   • Hostname: 127.0.0.1
   • Port: 3306
   • Username: root
   • Password: Store in Keychain... 클릭 후 MariaDB root 비밀번호 입력.
4. Test Connection 클릭
   • "Successfully made the MySQL connection" 메시지가 나오면 정상 연결! 🎉

---

📌 5. 발생했던 오류 및 해결 방법

❌ 1. Access denied for user 'root'@'localhost'

오류 메시지
ERROR 1698 (28000): Access denied for user 'root'@'localhost'

✅ 해결 방법

• sudo mysql -u root로 접속 후 다음 SQL 실행

  UPDATE mysql.user SET plugin = 'mysql_native_password' WHERE user = 'root';
  FLUSH PRIVILEGES;

• root 비밀번호 재설정 후 재시작.

---

❌ 2. MySQL Workbench 연결 오류 ("Can't connect to MySQL server on '127.0.0.1' (61)")

🚨 원인: MariaDB가 TCP/IP 연결을 차단한 상태.

✅ 해결 방법
1. MariaDB 설정 파일 수정
sudo nano /opt/homebrew/etc/my.cnf
2. [mysqld] 섹션 아래에 다음을 추가:

bind-address = 0.0.0.0

3. MariaDB 재시작
   brew services restart mariadb

---

❌ 3. 포트 충돌로 인해 MySQL Workbench 연결 안 됨

✅ 해결 방법
sudo lsof -i :3306

• 다른 프로세스가 포트 3306을 점유하고 있다면 종료 후 MariaDB 실행.

  brew services restart mariadb

---

🎯 최종 정리

단계	명령어
MariaDB 설치	brew install mariadb
MariaDB 시작 (백그라운드 실행)	brew services start mariadb
MariaDB 중지 (백그라운드 실행 중지)	brew services stop mariadb
MariaDB 재시작	brew services restart mariadb
MariaDB 상태 확인	brew services list
MariaDB 일회성 실행	mysql.server start
MariaDB 일회성 종료	mysql.server stop
MariaDB 비밀번호 설정	ALTER USER 'root'@'localhost' IDENTIFIED BY 'newpassword';
MariaDB TCP/IP 활성화	bind-address = 0.0.0.0 추가 후 재시작
포트 충돌 확인	sudo lsof -i :3306
MySQL Workbench 연결	127.0.0.1, 3306, root 계정 사용