# Часть восьмая. Настройка базы данных
**Цель:** Создать и настроить базы данных
**Задачи:**
* Создание файла сборки базы данных
* Создание базы данных
* Миграция баз данных
* Отображение баз данных в динамическом режиме
## Создание шаблона сборки базы данных
Статьи, которые выведены на сайте созданы при помощи ручного кодирования. Нам необходимо сделать так, чтобы статья формировалась сама из базы данных, которую сейчас мы создадим и настроим.
Откроем файл models.py. Мы делаем базу данных только для приложения blog, а это значит, что и работать будем из директории приложения.
Сейчас этот файл выглядит так:
```python
from django.db import models
# Create your models here.
```
Напишем небольшой код:
```python
from django.db import models
from django.utils import timezone
from django.contrib.auth.models import User
class New(models.Model):
title = models.CharField(max_length=100)
text = models.TextField()
data = models.DateTimeField(default=timezone.now)
author = models.ForeignKey(User, on_delete=models.CASCADE)
```
Построчно разберёмся в коде. Первая строка – импорт модели базы данных мы не меняем. Вторая строка и вторая библиотека, которая нам понадобится – `timezon`. Мы будем делать вывод текущих даты и времени после написания статьи. Последняя библиотека, которая нам нужна – `User`. Она нужна для того, чтобы из таблички пользователей взять авторов и поместить её в новую таблицу. С библиотеками закончили. Теперь – сам класс New.
Таблица, которую мы можем увидеть в панели администратора (см. предыдущий урок) – это класс со значениями. Нам нужно сделать таблицу с четырьмя столбцами – заголовок статьи (`title`), текст статьи (`text`), дата публикации (`data`) и автор статьи (`author`). Автором может быть только тот пользователь, который есть в таблице `Users`.
Каждый столбец принимает отдельный тип данных. В столбце `title` мы будем принимать текст, максимальная длина которого – 100 символов (`models.CharField(max_length=100)`). То есть, мы обращаемся к библиотеке `models`, из неё берём объект `CharField` (ввод строки) и выставляем это поле на максимальную длину на 100 символов (`max_length=100`). В столбце `text` мы берём текстовое поле без ограничений в размере. Текст – html-текст. В `data` мы поместим дату публикации. Для этого мы вводим поле даты (`DateTimeField`) и выставляем значением по умолчанию текущую дату и время в часовой зоне пользователя (Django способен определять зону по IP-адресу и синхронизировать время с зоной). Последний столбец – автор публикации (`author`). Так как, пользователи уже созданы и находятся в таблице `Users`, нам не требуется заново их вводить, а нужно лишь обратиться за ключом (в каждой таблице элемент называется ключом) и вывести его. Для этого обратимся к `ForeignKey`. Запросим таблицу с данными – `User`. Если же пользователь с сайта будет удалён, мы можем вывести вместо его имени что-то (например, фразу "User deleted") или же мы можем удалить эту запись совсем. Я выбрал удаление записи, так как оно сложнее в написании и будет этот метод выглядеть так: `on_delete=models.CASCADE`. Если же на нужно оставить запись и вывести фразу, то делается это так: `on_delete='User deleted'`. Как вы видите, ничего сложного.
Теперь выполним миграцию. Введём знакомую команду:
```
python manage.py makemigrations
```
Диалог сообщает нам о создании новой модели New:
```
C:\Users\Valery\PycharmProjects\MySite>python manage.py makemigrations
Migrations for 'blog':
blog\migrations\0001_initial.py
- Create model New
```
Откроем в нашем приложении папку миграций: C:\Users\Valery\PycharmProjects\MySite\blog\migrations
В папке мы можем увидеть созданный нами файл – `0001_initial.py`. Заглянем внутрь файла:
```python
# Generated by Django 3.0.3 on 2020-05-20 10:35
from django.conf import settings
from django.db import migrations, models
import django.db.models.deletion
import django.utils.timezone
class Migration(migrations.Migration):
initial = True
dependencies = [
migrations.swappable_dependency(settings.AUTH_USER_MODEL),
]
operations = [
migrations.CreateModel(
name='New',
fields=[
('id', models.AutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
('title', models.CharField(max_length=100)),
('text', models.TextField()),
('data', models.DateTimeField(default=django.utils.timezone.now)),
('author', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, to=settings.AUTH_USER_MODEL)),
],
),
]
```
Файл создан Django автоматически. В классе миграции обратите внимание на список operations. Мы задали имя новой таблице и в неё ввели все данные (title, text, data, author). Плюс к этому, перед всеми элементами списка был автоматически создан элемент id. На каждом сайте все элементы должны иметь свой уникальный номер в вёрстке (id). Этот элемент создаётся Django автоматически.
## Создание базы данных
Нужно понимать, что файл с расширением .py не является базой данных. Базы данных хранятся в sql-файлах. Исправим же это.
Запустим ещё пару команд:
```
python manage.py sqlmigrate blog 0001
python manage.py migrate
```
Первой командой мы запустили процесс сборки sql-файла из файла `0001_initial.py`. Второй командой выполнили полную миграцию баз данных.
Диалоги:
```
C:\Users\Valery\PycharmProjects\MySite>python manage.py sqlmigrate blog 0001
BEGIN;
--
-- Create model New
--
CREATE TABLE "blog_new" ("id" integer NOT NULL PRIMARY KEY AUTOINCREMENT,
"title" varchar(100) NOT NULL, "text" text NOT NULL, "data" datetime NOT NULL,
"author_id" integer NOT NULL REFERENCES "auth_user" ("id") DEFERRABLE INITIALLY
DEFERRED);
CREATE INDEX "blog_new_author_id_eb387d4f" ON "blog_new" ("author_id");
COMMIT;
C:\Users\Valery\PycharmProjects\MySite>python manage.py migrate
Operations to perform:
Apply all migrations: admin, auth, blog, contenttypes, sessions
Running migrations:
Applying blog.0001_initial... OK
```
Запустим сервер и проверим результат:
Как мы видим, в панели администратора ничего нет. Исправим это перейдя в файл admin.py
В нём нет ничего нужного нам для вывода:
```python
from django.contrib import admin
# Register your models here.
```
Исправим это:
```python
from django.contrib import admin
from .models import New
admin.site.register(New)
```
Из файла models.py мы запросили класс New и зарегистрировали его на сайте одной командой.
Проверка:
Всё работает. Обратите внимание, к каждому классу добавляется автоматически буква "s" в конце.
## Добавление записей
Создадим несколько статей. Нажмём на News и в верхнем правом углу нажмём кнопку «ADD NEW»
Введём любые данные в поля и сохраним результат. Я ввёл 3 примера статей:
## Динамический вывод базы данных
Теперь мы можем удалять/добавлять/изменять статьи в графическом режиме из панели администратора. Но на сайте мы видим следующую картину:
Исправим это. Зайдём в файл, который передаёт все данные на html-страницы (views.py). Мы увидим следующую картину статических данных (news):
```python
from django.shortcuts import render
news = [
{
'title': 'Первая запись',
'text': 'Много-много текста',
'date': '10 Мая 2020',
'author': 'Валерий'
},
{
'title': 'Вторая запись',
'text': 'Снова много-много текста',
'date': '19 Мая 2020',
'author': 'Егор'
}
]
def home(request):
data = {
'news': news,
'title': 'Главная страница'
}
return render(request, 'blog/home.html', data)
def contacts(request):
return render(request, 'blog/contacts.html', {'title': 'Страничка про МИИГАиК'})
```
Исправим все данные в этом файле:
```python
from django.shortcuts import render
from .models import New
def home(request):
data = {
'news': New.objects.all(),
'title': 'Главная страница'
}
return render(request, 'blog/home.html', data)
def contacts(request):
return render(request, 'blog/contacts.html', {'title': 'Страничка про МИИГАиК'})
```
Единственные 2 пункта, которые нужно поменять:
* Импорт New
* Передача всех объектов в файле New (`'news': New.objects.all(),`)
Проверка:
Почти победа, но исчезла дата публикации. Исправим. В файле home.py мы назвали переменную передачу даты – date, а в базе данных – data. Изменим 1 букву и получим:
```markup
{% extends 'blog/main.html' %}
{% block main_section %}
{% for post in news %}
{{ post.title }}
{{ post.text }}
Публикация: {{ post.data }}
{% if post.author == 'Валерий' %}
Автор: Админ
{% else %}
Автор: {{ post.author }}
{% endif %}
{% endfor %}
{% endblock main_section %}
```
Единственный момент, который сейчас не удобен и выглядит странно – дата. Во-первых, оно выглядит не красиво и во-вторых, на английском языке.
Подредактируем файл home.html, а конкретно строку:
```markup
Публикация: {{ post.data }}
```
Исправим это на:
```markup
Дата: {{ post.data|date:'j F Y, время: H:i:s' }}
```
Все ключи я брал из документации Django –
Результат:
Последний штрих – изменим американский «May» на русский «Май». Переходим в файл настройки всего проекта (setting.py) и найдём строку:
```python
LANGUAGE_CODE = 'en-us'
```
Заменим её на:
```python
LANGUAGE_CODE = 'ru-RU'
```
Результат:
Мало того, что мы изменили язык на сайте, мы ещё и перевели его панель администратора:
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://valerylinkov2504.gitbook.io/sitepython/8.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.