【Django第一步】第二部分:数据库和模型
@[Django| 翻译|python]
本教程中我们将设置数据库,创建你的第一个模型,并快速介绍Django自动生成的管理站点
数据库设置
现在,打开mysite/settings.py
,这是个普通的用来设置Django的模块
默认情况下,配置使用SQLite。如果你是数据库新手,或者你只是想尝试Django,这是最简单的选择。SQLite包含在Python中,所以你不需要安装其他任何东西来支持你的数据库。然而,当开始你的第一个真正的项目时,你可能想要使用像PostgreSQL这样的更具可扩展性的数据库,以避免数据库切换麻烦
如果您希望使用其他数据库,请安装适当的数据库,并在项目中更改以下键 以匹配数据库连接设置:DATABASES 'default'
ENGINE-
'django.db.backends.sqlite3'
,'django.db.backends.postgresql'
,'django.db.backends.mysql'
,或'django.db.backends.oracle'
。其他也可
NAME - 数据库的名称。如果您使用SQLite,数据库将成为您计算机上的文件; 在这种情况下,NAME 应该是该文件的完整绝对路径,包括文件名。默认值,将把文件存储在你的项目目录中。os.path.join(BASE_DIR, 'db.sqlite3')
如果你不使用SQLite作为数据库,额外的设置,例如 USER,PASSWORD和HOST必须加入。有关更多详细信息,请参阅参考文档DATABASES。
在编辑时mysite/settings.py
,请设置TIME_ZONE
为您的时区。
另外,请注意INSTALLED_APPS
文件顶部的设置。它包含在此Django实例中激活的所有Django应用程序的名称。应用程序可以用于多个项目,您可以打包并分发这些应用程序以供他人在其项目中使用。
默认情况下,INSTALLED_APPS包含以下应用程序,所有这些应用程序都附带Django:
- django.contrib.admin - 管理网站。你会很快使用它。
- django.contrib.auth - 一个认证系统。
- django.contrib.contenttypes - 内容类型的框架。
- django.contrib.sessions - 会话框架。
- django.contrib.messages - 消息传递框架。
- django.contrib.staticfiles - 一个管理静态文件的框架。
默认情况下包含这些应用程序,以方便常见情况。
但是其中一些应用程序至少使用了一个数据库表,所以我们需要在数据库中创建表格,然后才能使用它们。为此,请运行以下命令:
python manage.py migrate
该migrate命令查看INSTALLED_APPS设置并根据mysite/settings.py文件中的数据库设置以及应用程序随附的数据库迁移(稍后将介绍这些数据库迁移)创建任何必需的数据库表
创建模型
在我们的民意调查app中,我们将创建两个模型Question
和Choice。一个Question有一个问题和一个发布日期。一个Choice有一个与之关联的Question
现在我们在polls/models.py
中编辑如下代码
from django.db import models
class Question(models.Model):
question_text = models.CharField(max_length=200)
pub_date = models.DateTimeField('date published')
class Choice(models.Model):
question = models.ForeignKey(Question, on_delete=models.CASCADE)
choice_text = models.CharField(max_length=200)
votes = models.IntegerField(default=0)
代码非常直白,每个模型都是由models.Model
继承来的,每个变量都代表一个数据库的字段
每个字段都由Feild类的实例表示,比如CharFeild
表示字符字段,DateTimeFeild
表示时间字段。同时也告诉Django每个字段的数据类型
每个Feild实例的名字(例如question_text
或pub_date
)是该字段的名字。你将在python代码中使用这个值,并且数据库会以此作为列名称
您可以使用可选的第一个位置参数 Field来指定一个人类可读的名称。
在这个例子中,我们只定义了一个人类可读的名字Question.pub_date。对于此模型中的所有其他字段,该字段的机器可读名称将作为其人类可读名称就足够了。
有些Field类需要参数。 CharField例如,要求你给它一个 max_length。这不仅在数据库模式中使用,而且在验证中使用,我们很快就会看到。
A Field也可以有各种可选参数; 在这种情况下,我们已将default值 设置votes为0。
最后,注意一个关系是使用定义的 ForeignKey。这告诉Django每一个Choice都与单个Question相关。Django支持所有常见的数据库关系:多对一,多对多和一对一。
激活模型
这一小部分模型代码为Django提供了大量信息。有了它,Django能够:
- 为此应用程序创建数据库模式(语句)。CREATE TABLE
- 创建一个用于访问Question和Choice对象的Python数据库访问API 。
但首先我们需要告诉我们的项目,该polls应用程序已安装。
要将应用程序包含进项目中,我们需要在设置中添加对其配置类的引用INSTALLED_APPS
。该PollsConfig
一般在polls/apps.py
,所以它对应的路径是polls.apps.PollsConfig
。编辑该mysite/settings.py
文件并且将其路径添加到INSTALLED_APPS
设置
INSTALLED_APPS = [
'polls.apps.PollsConfig',
'django.contrib.admin',
'django.contrib.auth',
'django.contrib.contenttypes',
'django.contrib.sessions',
'django.contrib.messages',
'django.contrib.staticfiles',
]
现在Django知道应该包含polls应用程序,然后需要在命令行下运行命令
python manage.py makemigration polls
可以看到输出如下
(venv) E:\python\mysite>python manage.py makemigrations polls
Migrations for 'polls':
polls\migrations\0001_initial.py
- Create model Choice
- Create model Question
- Add field question to choice
通过运行makemigrations,您告诉Django您已经对模型进行了一些更改(在这种情况下,您已经创建了新模型),并且您希望将更改存储为迁移。
迁移是Django如何将更改存储到模型(以及数据库模式) - 它们只是磁盘上的文件。如果你喜欢,你可以阅读新模型的迁移; 这是文件 polls/migrations/0001_initial.py。别担心,Django每次创建时都不会读取它们,但是它们的设计是可以人为编辑的,以防您想要手动调整Django如何更改内容。
有一个命令可以为你运行迁移并自动管理你的数据库模式 - 这就是所谓的migrate,我们马上就会谈到 - 但首先,让我们看看迁移的SQL会运行什么。该 sqlmigrate命令采用迁移名称并返回它们的SQL:
python manage.py sqlmigrate polls 0001
然后就可以看到如下内容
BEGIN;
--
-- Create model Choice
--
CREATE TABLE "polls_choice" (
"id" serial NOT NULL PRIMARY KEY,
"choice_text" varchar(200) NOT NULL,
"votes" integer NOT NULL
);
--
-- Create model Question
--
CREATE TABLE "polls_question" (
"id" serial NOT NULL PRIMARY KEY,
"question_text" varchar(200) NOT NULL,
"pub_date" timestamp with time zone NOT NULL
);
--
-- Add field question to choice
--
ALTER TABLE "polls_choice" ADD COLUMN "question_id" integer NOT NULL;
ALTER TABLE "polls_choice" ALTER COLUMN "question_id" DROP DEFAULT;
CREATE INDEX "polls_choice_7aa0f6ee" ON "polls_choice" ("question_id");
ALTER TABLE "polls_choice"
ADD CONSTRAINT "polls_choice_question_id_246c99a640fbbd72_fk_polls_question_id"
FOREIGN KEY ("question_id")
REFERENCES "polls_question" ("id")
DEFERRABLE INITIALLY DEFERRED;
COMMIT;
请注意以下几点:
- 确切的输出将取决于您使用的数据库。上面的例子是为PostgreSQL生成的。
- 表名是通过组合应用程序的名称(自动生成polls)和模型的小写名字- question和 choice。(您可以覆盖此行为。)
- 主键(ID)会自动添加。(你也可以覆盖它。)
- 按照惯例,Django追加”_id”到外键字段名称。(是的,你也可以重写这个。)
- 外键关系通过 约束来显式化。不要担心部件; 这只是告诉PostgreSQL在事务结束之前不执行外键。FOREIGN KEYDEFERRABLE
- 它针对您正在使用的数据库量身定制,因此数据库特定的字段类型(例如auto_increment(MySQL),serial(PostgreSQL)或(SQLite))会自动处理。字段名称的引用也是如此 - 例如,使用双引号或单引号。integer primary key autoincrement
- 该sqlmigrate命令实际上不会在数据库上运行迁移 - 它只是将其打印到屏幕上,以便您可以看到SQL Django认为需要什么。这对于检查Django要做什么或者如果您有需要SQL脚本进
行更改的数据库管理员很有用。
如果你有兴趣,你也可以运行
python manage.py check
这可以检查项目中的任何问题,而无需进行迁移或触摸数据库。
现在,migrate再次运行以在您的数据库中创建这些模型表
python manage.py migrate
该migrate命令获取所有尚未应用的迁移(Django使用数据库中的特殊表跟踪哪些应用程序被调用django_migrations),并根据数据库运行它们
迁移非常强大,随着时间的推移,您可以随时更改模型,而无需删除数据库或表并创建新的数据库 - 它专门用于实时升级数据库,而不会丢失数据。我们将在本教程的后面部分更深入地介绍它们,但现在请记住进行模型更改的三步指南:
- 改变你的模型(in models.py)。
- 运行创建迁移python manage.py makemigrations
- 运行以将这些更改应用于数据库。python manage.py migrate
之所以有单独的命令来进行和应用迁移,是因为您将迁移到您的版本控制系统并将它们与您的应用程序一起提供; 它们不仅使您的开发更容易,而且还可以被其他开发人员和生产使用。
阅读django-admin文档以获取该manage.py实用程序可以执行的操作的完整信息。
使用
接下来的操作都在python shell里进行,这个同样也集成在pycharm中,同样在右下角,有一个python console
,点击即可
或者命令行敲入
python manage.py shell
接下来,我们就要在shell中探索一下数据库API
>>> from polls.models import Question, Choice # Import the model classes we just wrote.
# No questions are in the system yet.
>>> Question.objects.all()
<QuerySet []>
# Create a new Question.
# Support for time zones is enabled in the default settings file, so
# Django expects a datetime with tzinfo for pub_date. Use timezone.now()
# instead of datetime.datetime.now() and it will do the right thing.
>>> from django.utils import timezone
>>> q = Question(question_text="What's new?", pub_date=timezone.now())
# Save the object into the database. You have to call save() explicitly.
>>> q.save()
# Now it has an ID.
>>> q.id
1
# Access model field values via Python attributes.
>>> q.question_text
"What's new?"
>>> q.pub_date
datetime.datetime(2012, 2, 26, 13, 0, 0, 775217, tzinfo=<UTC>)
# Change values by changing the attributes, then calling save().
>>> q.question_text = "What's up?"
>>> q.save()
# objects.all() displays all the questions in the database.
>>> Question.objects.all()
<QuerySet [<Question: Question object (1)>]>
但是显示onject(1)不太好,所以我们为models加入两个方法
`str()“向模型中添加方法非常重要,这不仅仅是为了您在处理交互式提示时的方便,还因为在Django的自动生成的管理中使用了对象的表示。
请注意,这些是普通的Python方法。让我们添加一个自定义方法,仅供演示:
from django.db import models
import datetime
from django.utils import timezone
class Question(models.Model):
question_text=models.CharField(max_length=200)
pub_date=models.DateTimeField('date published')
def __str__(self):
return self.question_text
def was_published_recently(self):
return self.pub_date >= timezone.now() - datetime.timedelta(days=1)
class Choice(models.Model):
question=models.ForeignKey(Question,on_delete=models.CASCADE)
choice_text=models.CharField(max_length=200)
votes=models.IntegerField(default=0)
def __str__(self):
return self.choice_text
通过再次运行保存这些更改并启动一个新的Python交互式shell :
python manage.py shell
>>> from polls.models import Question, Choice
# Make sure our __str__() addition worked.
>>> Question.objects.all()
<QuerySet [<Question: What's up?>]>
# Django provides a rich database lookup API that's entirely driven by
# keyword arguments.
>>> Question.objects.filter(id=1)
<QuerySet [<Question: What's up?>]>
>>> Question.objects.filter(question_text__startswith='What')
<QuerySet [<Question: What's up?>]>
# Get the question that was published this year.
>>> from django.utils import timezone
>>> current_year = timezone.now().year
>>> Question.objects.get(pub_date__year=current_year)
<Question: What's up?>
# Request an ID that doesn't exist, this will raise an exception.
>>> Question.objects.get(id=2)
Traceback (most recent call last):
...
DoesNotExist: Question matching query does not exist.
# Lookup by a primary key is the most common case, so Django provides a
# shortcut for primary-key exact lookups.
# The following is identical to Question.objects.get(id=1).
>>> Question.objects.get(pk=1)
<Question: What's up?>
# Make sure our custom method worked.
>>> q = Question.objects.get(pk=1)
>>> q.was_published_recently()
True
# Give the Question a couple of Choices. The create call constructs a new
# Choice object, does the INSERT statement, adds the choice to the set
# of available choices and returns the new Choice object. Django creates
# a set to hold the "other side" of a ForeignKey relation
# (e.g. a question's choice) which can be accessed via the API.
>>> q = Question.objects.get(pk=1)
# Display any choices from the related object set -- none so far.
>>> q.choice_set.all()
<QuerySet []>
# Create three choices.
>>> q.choice_set.create(choice_text='Not much', votes=0)
<Choice: Not much>
>>> q.choice_set.create(choice_text='The sky', votes=0)
<Choice: The sky>
>>> c = q.choice_set.create(choice_text='Just hacking again', votes=0)
# Choice objects have API access to their related Question objects.
>>> c.question
<Question: What's up?>
# And vice versa: Question objects get access to Choice objects.
>>> q.choice_set.all()
<QuerySet [<Choice: Not much>, <Choice: The sky>, <Choice: Just hacking again>]>
>>> q.choice_set.count()
3
# The API automatically follows relationships as far as you need.
# Use double underscores to separate relationships.
# This works as many levels deep as you want; there's no limit.
# Find all Choices for any question whose pub_date is in this year
# (reusing the 'current_year' variable we created above).
>>> Choice.objects.filter(question__pub_date__year=current_year)
<QuerySet [<Choice: Not much>, <Choice: The sky>, <Choice: Just hacking again>]>
# Let's delete one of the choices. Use delete() for that.
>>> c = q.choice_set.filter(choice_text__startswith='Just hacking')
>>> c.delete()
有关模型关系的更多信息,请参阅访问相关对象。有关如何使用双下划线通过API执行字段查找的更多信息,请参阅字段查找。有关数据库API的完整详细信息,请参阅我们的数据库API参考。
介绍Django
为您的员工或客户生成管理网站以添加,更改和删除内容是一项繁琐的工作,不需要太多创造性。出于这个原因,Django完全自动为模型创建管理界面。
创建管理员用户
首先,我们需要创建一个可以登录管理网站的用户。运行以下命令:
python manage.py createsuperuser
输入你想要的用户名并按回车。
Username: admin
您将被提示输入您想要的电子邮件地址:
Email address: admin@example.com
最后一步是输入您的密码。您将被要求输入两次密码,第二次作为第一次确认。
>
Password: ****
Password (again): ***
Superuser created successfully.
进入管理网站
然后登陆127.0.0.1:8000/admin,输入用户名和密码即可进入管理员站点
您应该看到几种可编辑的内容:组和用户。它们django.contrib.auth由Django 提供的身份验证框架提供。
修改polls管理
但我们的民意调查程序在哪里?它不显示在管理索引页面上。
只需要做一件事:我们需要告诉管理员Question 对象具有管理界面。要做到这一点,打开polls/admin.py 文件,并编辑它看起来像这样:
from django.contrib import admin
from .models import Question
admin.site.register(Question)
探索管理功能
刷新管理页面
然后即可对数据进行编辑,编辑后save即可
这里需要注意的事项:
- 表格是从Question模型自动生成的。
- 不同的模型字段类型(DateTimeField, CharField)对应于适当的HTML输入小部件。每种类型的领域都知道如何在Django管理中显示自己。
- 每个DateTimeField获得免费的JavaScript快捷方式。日期获取“今日”快捷键和日历弹出窗口,时间显示“现在”快捷方式以及列出常用时间的便捷弹出窗口。
页面的底部给你几个选项:
- 保存 - 保存更改并返回到此类型对象的更改列表页面。
保存并继续编辑 - 保存更改并重新加载此对象的管理页面。
保存并添加另一个 - 保存更改并为此类型的对象加载一个新的空白表单。 - 删除 - 显示删除确认页面。
- 如果“发布日期”的值与您在教程1中创建问题的时间不匹配,则可能意味着您忘记为设置设置正确的值TIME_ZONE。更改它,重新加载页面并检查是否显示正确的值。
点击“今日”和“现在”快捷键,更改“发布日期”。然后点击“保存并继续编辑”,然后点击右上角的“历史记录”。您将看到一个页面,列出通过Django管理员对此对象所做的所有更改,以及进行更改的人员的时间戳和用户名