django学习-数据库配置-创建模型

 数据库配置

在mysite/settings.py中,包含了django项目设置的python模块

 

通常,这个配置文件使用SQLite作为默认数据库。如果你不熟悉数据库,或者只是想尝试下django,这是最简单的选择。python内置SQLite,所以你无需安装额外东西来使用它。当你开始一个真正的项目时,你可能更倾向使用一个更具扩展性的数据库,例如PostgreSQL,避免中途切换数据库这个令人头疼的问题。

 

如果想使用其他数据库,需要安装合适的database bindlings,然后改变设置文件中DATABASE ‘default’项目中的一些键值:

例如:

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.sqlite3',
        'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
    }
}

 

  

DATABASE ‘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 = {
    'default': {
        'ENGINE': 'django.db.backends.postgresql',
        'NAME': 'mydatabase',
        'USER': 'mydatabaseuser',
        'PASSWORD': 'mypassword',
        'HOST': '127.0.0.1',
        'PORT': '5432',
    }
}

 

SQLite以外的其他数据库

如果使用了SQLite以外的数据库,请确认在使用前已经创建了数据库。你可以通过在你的数据库交互命令行中使用”CREATE DATABASE database_name;”命令来完成这件事。

 

另外,还要确保该数据库用户提供操作mysite/settings.py具有”create database”权限。这使得自动创建的test database能被以后的教程使用。

 

如果你使用SQLite,name你不需要在使用前做任何事—数据库会在需要的时候自动创建。

 

编辑mysite/settings.py文件前,先设置TIME_ZONE为你自己时区。

 

此外,关注一下文件头部的INSTALLED_APPS设置项。这里包含了会在你项目中启用的所有django应用。应用能在多个项目中使用,你也可以打包并且发布应用,让别人使用它们。

例如:

INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
]

 

INSTALLED_APPS

通常,INSTALLED_APPS默认包括了以下django的自带应用:

 

django.contrib.admin- 管理员站点

django.contrib.auth-认证授权系统

django.contrib.contenttypes-内容类型框架

django.contrib.sessions-会话框架

django.contrib.messages—消息框架

django.contrib.staticfiles-管理静态文件的框架

 

这些应用被默认启用是为了给常规项目提供方便。

默认开启的某些应用需要至少一个数据表,所以,在使用他们之前需要在数据库中创建一些表。

py -3 manage.py migrate数据库迁移命令

这个migrate命令检查INSTALLED_APPS设置,为其中的每个应用创建需要的数据表,至于具体会创建什么,这取决于你的mysite/settings.py设置文件和每个应用的数据库迁移文件。这个命令所执行的每个迁移操作都会在终端中显示出来。

 django学习-数据库配置-创建模型

可以运行show tables;查看django具体创建哪些表:

django学习-数据库配置-创建模型

 

 

django默认激活了一些应用,但并不是每个人都需要他们。如果我们不需要某个或某些应用,可以在运行migrate前从INSTALLED_APPS里注释或删掉他们。

migrate命令只会为在INSTALLED_APPS里声明了的应用进行数据库迁移。

 

创建模型

在django里写一个数据库驱动的web应用的第一步是定义模型-也就是数据库结构设计和附加的其他元数据。

 

模型是真实数据的简单明确的描述。它包含了储存的数据所必要的字段和行为。django遵循DRY Principle(不重复造*)。它的目标是你只需要定义数据模型,然后其他的杂七杂八的代码你都不用关心,他们会自动从模型生成。

 

来介绍一下迁移-举个例子,django的迁移代码是由你的模型文件自动生成的,它本质上只是个历史记录,django可以用它来进行数据库的滚动更新,通过这种方式使其能够和当前的模型匹配。

 

在这个简单的投票应用中,需要创建两个模型:问题Question和选项Choice。Question模型包括问题描述和发布时间。Choice模型有两个字段,选项描述和当前得票数。每个选项属于一个问题。

 

这些概念可以通过一个简单的python类来描述。按照下面的例子来编辑polls/models.py文件:

 

from django.db import models

# Create your models here.

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)

代码非常直白,每个模型被表示为django.db.models.Model类的子类。每个模型有一些类变量,他们都表示模型里的一个数据库字段。

 

每个字段都是Field类的实例-比如,字符字段被表示为CharField,日期时间被表示为DateTimeField。这将高速django每个字段要处理的数据类型。

 

每个Field类实例变量的名称(例如question_text或pub_date)也是字段名,所以最好使用对机器友好的格式。你将会在pythob代码里使用他们,而数据库会将它作为列名。

 

你可以使用可选的选项来为Field定义一个人类可读的名字。这个功能在很多django内部组成部分中都被使用了,而且作为文档的一部分。如果某个字段没有提供此名称,django将会使用对机器友好的名称,也就是变量名。

在上面的例子中,我们只为Question.pub_date定义了对人类友好的名字。对于模型内的其他字段,他们的机器友好名也会被作为人类友好名使用。

 

定义某些Field类实例需要参数。例如CharField需要一个max_length参数。这个参数的用处不至于用来定义数据库结构,也用于验证数据,我们稍后会看到这方面的内容。

 

Field也能够接收多个可选参数;在上面的例子中:我们将votes的default也就是默认值,设为0。

 

注意在最后,我们使用ForeighKey定义了一个关系。这将高速django,每个Choice对象都关联到一个Question对象。django支持所有常用的数据库关系:多对一、多对多和一对一。

 

 

激活模型

上面的一小队用于创建模型的代码给了django很多信息,通过这些信息,django可以做一下事情:

1)为这个应用创建数据库schema(生成CREATE TABLE语句)

2)创建可以与Question和Choice对象进行交互的python数据库API

 

但是首先得把polls应用安装到我们的项目里

 

设计哲学:

django应用是”可插拔”的。你可以在多个项目中使用同一个应用。除此之外,你还可以发布自己的应用,因为他们并不会绑定到当前安装的django上。

 

为了在我们的工程中包含这个应用,我们需要在配置类INSTALLED_APPS中添加设置。因为PollsConfig类写在文件polls/app.py中,所以它的点式路径是’polls.apps.PollsConfig’。在文件mysite/settings.py中INSTALLED_APP子项添加点式路径后,它看起来像这样:

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应用。接着运行下面的命令:

py -3 manage.py makemigrations polls生成迁移

 

你将会看到类似于下面这样的输出:

 django学习-数据库配置-创建模型

通过运行makemigrations命令,django会检测你对模型文件的修改(在这种情况下,你已经取得的新的),并且把修改的部分储存为一次迁移。

 

迁移是django对于模型定义(也就是你的数据库结构)的变化的储存形式-没那么玄乎,它们其实也只是一些你磁盘上的文件,可以阅读模型的迁移数据,在polls/migrations/0001_initial.py里。如下图:

 django学习-数据库配置-创建模型

 

 

django有一个自动执行数据迁移并同步管理你的数据库结果的命令-这个命令是migrate,我们马上会接触它。

但是首先,让我们看看迁移命令会执行哪些sql语句。

sqlmigrate命令接收一个迁移的名称,然后返回对应的SQL:
py -3 manage.py sqlmigrate polls 0001

你将会看到类似下面的输出(把输出重组成了人类可读的格式):

D:\django\mysite>py -3 manage.py sqlmigrate polls 0001

BEGIN;

--

-- Create model Question

--

CREATE TABLE `polls_question` (`id` integer AUTO_INCREMENT NOT NULL PRIMARY KEY, `question_text` varchar(200) NOT NULL, `pub_date` datetime(6) NOT NULL);

--

-- Create model Choice

--

CREATE TABLE `polls_choice` (`id` integer AUTO_INCREMENT NOT NULL PRIMARY KEY, `choice_text` varchar(200) NOT NULL, `votes` integer NOT NULL, `question_id` integer NOT NULL);

ALTER TABLE `polls_choice` ADD CONSTRAINT `polls_choice_question_id_c5b4b260_fk_polls_question_id` FOREIGN KEY (`question_id`) REFERENCES `polls_question` (`id`);

COMMIT;

django学习-数据库配置-创建模型

 

 

请注意以下几点:

1)输出的内容和你使用的数据库有关,上面的输出实例使用的mysql

2)数据库的表名是由应用名(polls)和模型名的小写形式(question和choice)连接而来。(如果需要,你可以自定义此行为。)

3)主键(IDs)会被自动创建。(当然,你也可以自定义)

4)默认的,django会在外键字段名后追加字符串”_id”。(同样,也可以自定义。)

5)外键关系有FOREIGN KEY生成。你不用关心DEFERRABLE部分(针对PostgreSQL),它是指告诉PostgreSQL,请在事务全都执行完之后再创建外键关系。

6)生成的SQL语句是为你所用的数据库定制的,所以那些和数据库有关的字段类型,比如auto_increment(MySQL)、serial(PostgreSQL)和integer primary key autoincrement(SQLite),django会帮你自动处理。那些和引号相关的事情-例如,是使用单引号还是双引号-也一样会被自动处理。

7)这个sqlmigrate命令并没有真正在你的数据库中执行迁移-它只是把命令输出到屏幕上,让你看看django认为需要执行哪些sql语句。这在你想看看django到底准备做什么,或者当你是数据库管理员,需要写脚本来批量处理数据库时会很有用。

 

py -3 manage.py check检查项目

可以运行py -3 manage.py check命令来帮助你检查项目中的问题,并且在检查过程中不会对数据库进行任何操作

 django学习-数据库配置-创建模型

运行migrate命令,在数据库里创建新定义的模型的数据表:

 

D:\django\mysite>py -3 manage.py migrate

Operations to perform:

  Apply all migrations: admin, auth, contenttypes, polls, sessions

Running migrations:

  Applying polls.0001_initial... OK

 

这个migrate命令选中所有还没有执行过的迁移(django通过在数据库中创建一个特殊的表django_migrations来跟踪执行过哪些迁移)并应用在数据库上-也就是将你对模型的更改同步到数据库结构上。

 

迁移是非常大的功能,它能让你在开发过程中持续的改变数据结构而不需要重新删除和创建表-它专注于是数据库平滑升级而不会丢失数据。我们会在后面的教程中更加深入的学习这部分内容,现在,你只要记住,改变模型需要以下三步:

 

改变模型的步骤

1)编辑models.py文件,改变模型。

2)运行python manage.py makemigrations为模型的改变生成迁移文件

3)运行python manage.py migrate来应用数据库迁移

 

数据库迁移被分解成生成和应用两个命令是为了让你能够在代码控制系统上提交迁移数据并使其能在多个应用里使用;这不仅仅会让开发更加简单,也给别的开发者和生产环境中的使用带来方便。

 

上一篇:Django的使用--初次创建视图views


下一篇:Django新建第一个投票应用