Django x MySQL 연동

Django에서 MySQL 연동하기

1. MySQL 서버 설치 및 DB 준비

-- MySQL에서 실행 (예: MySQL Workbench, CLI)
CREATE DATABASE aloha CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

-- 사용자 생성 및 권한 부여
CREATE USER 'aloha'@'localhost' IDENTIFIED BY '123456';
GRANT ALL PRIVILEGES ON aloha.* TO 'aloha'@'localhost';
FLUSH PRIVILEGES;
SQL
복사

2. MySQL 클라이언트 드라이버 설치

# pip로 mysqlclient 설치 (권장)
pip install mysqlclient

# 대체 옵션 (Windows에서 설치 어려울 경우)
# pip install pymysql
Shell
복사

mysqlclient는 C 기반이므로 Linux/Mac에서 성능 좋고 안정적입니다.

Windows에서는 설치 문제 시 pymysql도 사용 가능.

3. Django 프로젝트의 DB 설정

# mysite/settings.py

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.mysql',  # MySQL 백엔드 사용
        'NAME': 'aloha',                       # DB 이름
        'USER': 'aloha',                       # DB 사용자
        'PASSWORD': '123456',                  # 비밀번호
        'HOST': 'localhost',                   # 또는 IP 주소
        'PORT': '3306',                        # 기본 포트
        'OPTIONS': {
            'init_command': "SET sql_mode='STRICT_TRANS_TABLES'",
        },
    }
}
Python
복사

4. 마이그레이션 및 테스트

# 앱 생성 및 모델 정의 후
python manage.py makemigrations
python manage.py migrate

# 관리자 생성
python manage.py createsuperuser
Shell
복사

MySQL DB에 테이블이 잘 생성되는지 확인합니다.

5. pymysql 사용하는 경우 (선택사항)

# settings.py 가장 위에 추가
import pymysql
pymysql.install_as_MySQLdb()
Python
복사

ENGINE은 그대로 'django.db.backends.mysql' 유지합니다.

6. 문자 인코딩 문제 방지

MySQL DB 생성 시 utf8mb4 사용 권장:

CREATE DATABASE aloha CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
SQL
복사

OPTIONS에 다음도 추가 가능:

'OPTIONS': {
    'charset': 'utf8mb4',
}
Python
복사

실습 과제 예시

실습 제목	내용
사용자 목록 저장	MySQL DB에 사용자 이름, 이메일 저장
게시글 저장 앱	Post 모델을 MySQL에 저장하고 조회
관리자 페이지 연동	MySQL 데이터가 Django Admin에서 잘 보이는지 확인

트러블슈팅 팁

문제	해결 방법
'MySQLdb' not installed	pip install mysqlclient 또는 pymysql 우회
한글 깨짐	utf8mb4 charset 사용
DB 연결 오류	DB 명, 포트, 사용자, 비밀번호 재확인
migrate 시 오류	mysqlclient 재설치 후 진행