🐍파이썬 초보자 가이드 : Django 데이터베이스 만들기(단계별 가이드)

 

 

안녕하세요! 웹 개발을 시작하려는 초보 개발자님, 파이썬의 강력한 웹 프레임워크 **Django(장고)**를 만나보셨군요! Django를 사용하면 데이터베이스(DB) 연동을 매우 쉽고 재미있게 할 수 있습니다.

이번 블로그 글에서는 Django의 기본 데이터베이스인 SQLite를 사용하여 데이터베이스를 만들고 활용하는 방법을 초보자 눈높이에 맞춰 단계별로 설명해 드릴게요!

---

💡 1. Django와 데이터베이스: ORM의 마법 ✨

Django가 데이터베이스를 다루는 방식은 조금 특별합니다. 바로 **ORM(Object-Relational Mapping)**이라는 개념 덕분인데요.

• 쉽게 이해하기: 데이터베이스는 보통 SQL이라는 언어를 사용해서 다룹니다. 하지만 ORM은 우리가 사용하는 파이썬 **클래스(Class)와 객체(Object)**를 데이터베이스의 **테이블(Table)과 데이터(Data)**에 연결해주는 다리 역할을 합니다.

• 장점: 복잡한 SQL 쿼리를 직접 작성할 필요 없이, 파이썬 코드만으로 데이터베이스를 조작할 수 있게 됩니다. 이 파이썬 클래스가 바로 Django의 **Models(모델)**입니다.

---

🛠️ 2. 데이터베이스 설정 확인 (settings.py)

새로운 Django 프로젝트를 만들면, 기본적으로 SQLite 데이터베이스가 설정되어 있습니다. 이 설정은 프로젝트 폴더 안의 settings.py 파일에서 확인할 수 있어요.

Python

# settings.py 파일 내용 중
DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.sqlite3',
        'NAME': BASE_DIR / 'db.sqlite3',
    }
}

• 'default': 이 설정이 프로젝트의 주 데이터베이스라는 의미입니다.

• 'ENGINE': 어떤 종류의 데이터베이스를 사용할지 지정합니다. 기본값은 sqlite3입니다.

• 'NAME': 데이터베이스 파일의 이름과 위치를 지정합니다. 기본 설정대로라면, 프로젝트 최상위 폴더에 db.sqlite3 파일이 생성될 거예요.

📝 팁: 초보자에게는 별도의 설치 없이 바로 사용할 수 있는 SQLite가 가장 쉽습니다. 나중에 MySQL, PostgreSQL 같은 다른 DB로 변경할 수도 있어요!

---

🏗️ 3. 데이터베이스 모델(Model) 생성하기

실제 데이터베이스에 저장될 데이터의 **구조(스키마)**를 정의하는 단계입니다. 우리가 만든 앱 폴더(예: myapp) 안의 models.py 파일에 작성합니다.

예를 들어, 간단한 '게시글' 정보를 저장하는 모델을 만들어 봅시다.

Python

# myapp/models.py
from django.db import models

class Post(models.Model): # Post라는 이름의 데이터베이스 테이블을 만듭니다.
    title = models.CharField(max_length=100) # 제목(최대 100자 문자열)
    content = models.TextField()             # 내용(긴 텍스트)
    created_at = models.DateTimeField(auto_now_add=True) # 생성 시간(자동 저장)
    
    def __str__(self):
        return self.title # 객체를 출력할 때 제목이 보이도록 설정

• models.Model을 상속: 이 클래스가 Django의 ORM 모델임을 알려줍니다.

• 필드 정의: title, content 등이 데이터베이스 테이블의 **열(Column)**이 됩니다.

• 자동 ID: 모든 Django 모델에는 id 필드가 자동으로 생성되어 기본 키(Primary Key) 역할을 합니다.

---

⚙️ 4. 앱 등록 및 마이그레이션 실행하기

모델을 만들었다고 해서 바로 DB에 반영되는 것은 아닙니다. 두 단계를 거쳐야 합니다.

4.1. 앱 등록 (settings.py)

Django 프로젝트에게 새로운 앱(예: myapp)이 생겼고, 이 앱의 모델을 사용해야 한다는 것을 알려줘야 합니다.

프로젝트의 settings.py 파일로 돌아가서 INSTALLED_APPS 리스트에 앱 이름을 추가합니다.

Python

# settings.py 파일 내용 중
INSTALLED_APPS = [
    # ... 기본 앱들
    'django.contrib.admin',
    # ...
    # 여기에 추가합니다
    'myapp', # <--- 만든 앱의 이름을 추가
]

4.2. 마이그레이션 파일 생성 (makemigrations)

이제 Django에게 "내가 모델을 변경했으니, DB에 반영할 준비를 해줘!"라고 명령할 차례입니다.

가상 환경이 활성화된 터미널에서 다음 명령어를 실행합니다.

Bash

python manage.py makemigrations myapp

• 이 명령은 models.py의 변경 사항을 감지하여, 데이터베이스에 적용할 **설계도 파일(마이그레이션 파일)**을 myapp/migrations 폴더에 생성합니다.

4.3. 데이터베이스에 반영 (migrate)

마지막으로, 생성된 설계도 파일을 실제 데이터베이스(db.sqlite3 파일)에 적용하여 테이블을 생성합니다.

Bash

python manage.py migrate

• 이 명령을 실행하면, Django가 기본적으로 필요한 테이블(인증, 세션 등)과 우리가 만든 Post 모델에 해당하는 테이블을 모두 데이터베이스에 생성합니다.

---

✅ 5. 생성된 데이터베이스 확인

migrate 명령이 성공적으로 실행되었다면, 프로젝트 폴더에 db.sqlite3 파일이 생성되었을 것입니다.

이 파일은 일반적인 텍스트 편집기로는 열어볼 수 없지만, DB Browser for SQLite 같은 전용 프로그램을 사용하면 실제로 테이블이 잘 만들어졌는지 확인할 수 있습니다.

---

📝 마무리

축하합니다! 이제 파이썬 코드로 데이터베이스 테이블을 만들고, 실제 데이터베이스 파일에 반영하는 모든 과정을 마스터하셨습니다.

핵심 요약:

1. 모델 정의: models.py에서 파이썬 클래스로 데이터 구조(테이블)를 정의합니다.

2. 앱 등록: settings.py의 INSTALLED_APPS에 앱을 추가합니다.

3. 설계도 생성: python manage.py makemigrations로 변경 사항을 감지합니다.

4. DB 반영: python manage.py migrate로 실제 DB에 테이블을 만듭니다.

이 과정을 통해 Django의 Models와 Migrations 시스템이 얼마나 편리한지 느끼셨을 거예요.