Django DB 모델링

🔖 데이터베이스 모델링이란?

데이터베이스 모델링이란 일상 속에 존재하는 모든 것들 중 필요로하는 것을 데이터화 하여 프로그램으로 다루기 위해 속성들을 정의하며 Database화 시키는 것을 말한다.

예를들어 Jobs이라는 Table에 직업의 정보를 각 속성별로 정의하여 데이터를 넣어둘 수 있다.

• 직업이름
• 분류
• 근무지
• 변경일
• 생성일

➤ Django 모델링

• Django에서 id는 기본 값(Primary Key)정의 하지 않아도 자동 정의
• 외래키(Foreign Key)를 사용하면 뒤에 xxxx_id를 자동으로 생성
• Job에 위치 정보를 추가 하고 싶은데 해당 위치가 다른 테이블에 있다면 location으로 정의해주면 location_id로 데이터 외래키를 가진 컬럼이 생성됨

---

🔖 Django 칼럼타입

➤ 문자열

• CharField(길이가 고정적인 문자열)
• TextField(길이가 정해지지 않은 문자열)

➤ 숫자

• IntegerField(-2147483648~2147483647)
• PositiveIntegerField
• BigIntegerField(-9223372036854775808~9223372036854775807)
• PositiveBigIntegerField

➤ 날짜

• DateField(날짜)
• DateTimeField(날짜+시간)

➤ 기타

• BooleanField(True/False)
• EmailField(이메일 포멧)
• JSONField(Json 포멧)
• AutoField(Auto Increment 필드 with IntegerField)
• BigAutoField(Auto Increment 필드 with BigIntegerField)

➤ 외래키

• ForeignKey(다른 테이블 PK 참조 필드)

위에 언급한 타입외에도 다른 타입들도 있지만 일반적으로 많이 사용하는 칼럼들만 다뤄보려고 한다.

---

🔖 Django 모델링

먼저 모델링에 대해서 Django에서의 모델링은 무엇이며 어떤 컬럼 타입이 있는지 설명했지만, 사실 코드를 실제로 사용해 보지 않으면 정확히 와닿지 않기 때문에 실제로 코드를 만들어 보려고 한다.

일반적인 Django강의들을 살펴보면 대부분 처음 모델링에 대해 User를 많이 예시를 들어 설명하지는 나는 결제계획(PayPlan)을 기준으로 모델링을 시작해 보겠다.

➤ APP 생성

모델을 작성하기 위해 프로젝트안에 APP이 생성되어 있어야 한다. 이 APP에 작성된 모델링 코드를 기준으로 Database의 테이블과 칼럼들이 생성되기 때문에 APP의 생성이 우선되어야 한다.

# APP 생성 명령어
django-admin startapp shortener

위의 명령어를 실행하면 이미지와 같이 'shortener'라는 폴더가 생성되는 것을 확인 할 수 있다. 이 폴더안을 살펴보면 `models.py`파일이 있는데 여기에 모델링 코드를 작성하면 된다.

➤ 마이그레이션(Migration)

마이그레이션이란 모델의 변경 내역을 DB*스키마에 적용시키는 Django의 방법 이라고 장고 공식 문서에 설명되어 있다.

Django는 ORM을 사용하기 때문에 models.py와 클래스를 통해 DB스키마를 생성하고 컨트롤하게 되는데, 이때 DB스키마를 git 처럼 버전으로 관리할 수 있는 시스템이라 볼 수 있다.

---

명령어

• 마이그레이션 생성 : python3 manage.py makemigrations [app_name]
• 마이그레이션 적용 : python3 manage.py migrate [app_name][migration_name]
• 마이그레이션 확인 : python3 manage.py showmigrations [app_name]
• 마이그레이션 SQL 확인 : python3 manage.py sqlmigrate [app_name][migration_name]

---

1. app을 처음 생성하였다면 python3 manage.py migrate로 초기 마이그레이션을 진행하자.

2. 원하는 모델링 코드를 작성하였다면 python3 manage.py showmigrations [app_name]으로 마이그레이션 유무를 확인하자. 1번을 진행전에는 왼쪽과 같이, 진행 후에는 오른쪽과 같이 나온다.

   models.py

   from django.db import models
   
   # Create your models here
   
   class PayPlan(models.Model):
       name = models.CharField(max_length=20)
       price = models.IntegerField()
       updated_at = models.DateTimeField(auto_now=True)
       create_at = models.DateTimeField(auto_now_add=True)

3. python3 manage.py makemigrations [app_name]로 모델링 코드에 대한 마이그레이션을 생성하자. 아까와 다르게 생성한 app부분에 'no_migrations'표기가 사라지고 새로운 001번호를 가진 마이그레이션 파일이 생성된 것을 확인 할 수 있다.

4. 다시 python3 manage.py migrate로 마이그레이션을 진행후 마이그레이션을 확인해보자.
   

이제 모델링한 코드가 DB*스키마에 적용된 것이다.

001_initial

여기서 위에서 모델링 코드를 작성하여 생성한 마이그레이션 파일을 확인해 보자. name, price, updated_at, create_at 은 작성한 대로 생성하는 항목에서 확인이 된다.

하지만 id는 우리가 작성하지 않았는데 생성하는 항목으로 추가되어 있는 것이 보일 것이다. 이것은 primary_key로 칼럼을 작성하지 않으면 자동으로 장고에서 생성해주기 때문이다.

Django가 위의 파일에서 보이는 것과 같이 001, 002, 003...과 같이 생성되는 마이그레이션 파일이 누적되어 버전을 관리하고 있는 것이다.(절대 중간의 마이그레이션 파일을 삭제 하면 안된다.)

🔖 슈퍼 유저(admin)

Django는 관리자페이지에 대한 서비스가 무척이나 많이 제공된다. 그 중 하나가 관리자 계정을 생성하는 것인데 아래 명령어를 입력하여 관리자 슈퍼 유저를 생성해 보자.

python3 manage.py createsuperuser

1. 명령어 작성
2. Username 작성
3. Email 작성
4. Password 작성
5. Password 다시 작성 (Password가 8자리 넘지 않으면 경고문이 나오나 y 눌러 pass)

🔖 모델링 확인

위에서 작성한 PayPlan 테이블을 확인해 볼텐데 Django는 기본적으로 아무런 설정을 하지 않고 마이그레이션을 진행하면 sqlite로 파일이 생성된다.

프로젝트에서 db.sqlite3를 눌러서 열려고 시도하면 확인할 수 없다고 나올 것이다. EXTENSIONS에서 SQLite Viewer라는 패키지를 설치하고 다시한번 sqlite파일을 열어보자.

이와 같이 파일이 열리는 것을 확인했다면 Tables항목과 그 안에 shortener_payplan이라는 테이블이 있을 것이다.

그 안에 위에서 생성한 0001_initial파일의 내용 id, name, price, updated_at, create_at 칼럼이 생성된 것을 확인 할 수 있다.

🧑🏻‍💻 이 방법 외에도 관리자 페이지에 들어가거나 DB툴을 사용 등 확인 할 수 있는 방법은 다양하기 때문에 이 방법이 불편하면 구글링하여 Django DB를 확인 할 수 있는 나만의 방법을 찾아보자.