Python에서 MySQLdb 모듈 설치 방법 (Ubuntu·Fedora·pip 완전 정리)

MySQL 데이터베이스를 Python에서 다루려면 MySQLdb 모듈이 필요합니다. 본격적인 작업에 앞서, 먼저 내 컴퓨터에 MySQLdb가 설치되어 있는지 확인해야 합니다.

1. MySQLdb 설치 여부 확인하기

Python 스크립트에 아래 코드를 작성한 뒤 실행해 보세요.

#!/usr/bin/python
import MySQLdb

만약 실행 시 다음과 같은 에러가 출력된다면, MySQLdb 모듈이 아직 설치되지 않은 것입니다.

Traceback (most recent call last):
  File "test.py", line 3, in <module>
    import MySQLdb
ImportError: No module named MySQLdb

2. 운영체제별 MySQLdb 설치 방법

사용 중인 환경에 맞는 명령어로 모듈을 설치할 수 있습니다.

Ubuntu 사용자

필요한 의존 패키지와 함께 pip를 먼저 준비한 후 설치합니다.

$ sudo apt-get install python-pip python-dev libmysqlclient-dev

Fedora 사용자

개발 도구와 MySQL 관련 패키지를 함께 설치해야 합니다.

$ sudo dnf install python python-devel mysql-devel redhat-rpm-config gcc

pip 명령어로 직접 설치

Python 명령 프롬프트(터미널)에서는 pip를 이용해 간단히 설치할 수 있습니다.

pip install MySQL-python

3. 참고 사항

주의: 위 모듈들을 설치하려면 root(관리자) 권한이 반드시 필요합니다. 권한이 없다면 sudo 명령과 함께 실행하거나 관리자에게 요청하세요.

설치가 완료되면 처음의 import MySQLdb 코드를 다시 실행해 보세요. 오류 없이 실행된다면 정상적으로 설치된 것입니다.