Django 模型

Django 对各种数据库提供了很好的支持，包括：PostgreSQL、MySQL、SQLite、Oracle。

Django 为这些数据库提供了统一的调用API。我们可以根据自己业务需求选择不同的数据库。

MySQL 是 Web 应用中最常用的数据库。本章节我们将以 Mysql 作为实例进行介绍。你可以通过本站的 MySQL 教程了解更多 MySQL 的基础知识。

如果你没安装 mysql 驱动，可以执行以下命令安装：

sudo pip3 install pymysql

Django ORM

Django 模型使用自带的 ORM。

对象关系映射（Object Relational Mapping，简称 ORM ）用于实现面向对象编程语言里不同类型系统的数据之间的转换。

ORM 在业务逻辑层和数据库层之间充当了桥梁的作用。

ORM 是通过使用描述对象和数据库之间的映射的元数据，将程序中的对象自动持久化到数据库中。

使用 ORM 的好处：

提高开发效率。
不同数据库可以平滑切换。

使用 ORM 的缺点：

ORM 代码转换为 SQL 语句时，需要花费一定的时间，执行效率会有所降低。
长期写 ORM 代码，会降低编写 SQL 语句的能力。

ORM 解析过程:

1、ORM 会将 Python 代码转成为 SQL 语句。
2、SQL 语句通过 pymysql 传送到数据库服务端。
3、在数据库中执行 SQL 语句并将结果返回。

ORM 对应关系表：

数据库配置

Django 如何使用 mysql 数据库

创建 MySQL 数据库( ORM 无法操作到数据库级别，只能操作到数据表)语法：

create database 数据库名称 default charset=utf8; # 防止编码问题，指定为 utf8

例如常见 runcodex 数据库，编码指定为 utf8：

create database runcodex default charset=utf8;

我们在项目的 settings.py 文件中找到 DATABASES 配置项，将其信息修改为：

HelloWorld/HelloWorld/settings.py: 文件代码：

DATABASES = { 'default': { 'ENGINE': 'django.db.backends.mysql', # 数据库引擎 'NAME': 'runcodex', # 数据库名称 'HOST': '127.0.0.1', # 数据库地址，本机 ip 地址 127.0.0.1 'PORT': 3306, # 端口 'USER': 'root', # 数据库用户名 'PASSWORD': '123456', # 数据库密码 } }

如果你使用了 Python2.x 版本这里添加了中文注释，所以你需要在 HelloWorld/settings.py 文件头部添加 # -*- coding: UTF-8 -*-。

上面包含数据库名称和用户的信息，它们与 MySQL 中对应数据库和用户的设置相同。Django 根据这一设置，与 MySQL 中相应的数据库和用户连接起来。

接下来，告诉 Django 使用 pymysql 模块连接 mysql 数据库：

实例

# 在与 settings.py 同级目录下的 __init__.py 中引入模块和进行配置
import pymysql
pymysql.install_as_MySQLdb()

定义模型

创建 APP

Django 规定，如果要使用模型，必须要创建一个 app。我们使用以下命令创建一个 TestModel 的 app:

django-admin.py startapp TestModel

目录结构如下：

HelloWorld
|-- HelloWorld
|-- manage.py
...
|-- TestModel
|   |-- __init__.py
|   |-- admin.py
|   |-- models.py
|   |-- tests.py
|   `-- views.py

我们修改 TestModel/models.py 文件，代码如下：

HelloWorld/TestModel/models.py: 文件代码：

# models.py from django.db import models class Test(models.Model): name = models.CharField(max_length=20)

以上的类名代表了数据库表名，且继承了models.Model，类里面的字段代表数据表中的字段(name)，数据类型则由CharField（相当于varchar）、DateField（相当于datetime）， max_length 参数限定长度。

接下来在 settings.py 中找到INSTALLED_APPS这一项，如下：

INSTALLED_APPS = (
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    'TestModel',               # 添加此项
)

在命令行中运行：

$ python3 manage.py migrate   # 创建表结构

$ python3 manage.py makemigrations TestModel  # 让 Django 知道我们在我们的模型有一些变更
$ python3 manage.py migrate TestModel   # 创建表结构

看到几行 "Creating table…" 的字样，你的数据表就创建好了。

Creating tables ...
……
Creating table TestModel_test  #我们自定义的表
……

表名组成结构为：应用名_类名（如：TestModel_test）。

注意：尽管我们没有在 models 给表设置主键，但是 Django 会自动添加一个 id 作为主键。

常见报错信息

如果执行以上命令时会出现如下报错信息:

原因是 MySQLclient 目前只支持到 Python3.4，因此如果使用的更高版本的 python，需要修改如下：

通过报错信息的文件路径找到 ...site-packages\Django-2.0-py3.6.egg\django\db\backends\mysql 这个路径里的 base.py 文件，把这两行代码注释掉（代码在文件开头部分）：

if version < (1, 3, 13):
    raise ImproperlyConfigured('mysqlclient 1.3.13 or newer is required; you have %s.' % Database.__version__)

一般点报错的代码文件路径信息，会自动跳转到报错文件中行数，此时我们在报错的代码行数注释掉。

如果出现以下报错信息:

我们点报错的代码文件路径，跳转到报错文件中行数，此时我们在报错的代码行数之前加上:

query = query.encode()

数据库操作

接下来我们在 HelloWorld 目录中添加 testdb.py 文件（下面介绍），并修改 urls.py：

HelloWorld/HelloWorld/urls.py: 文件代码：

from django.urls import path from . import views,testdb urlpatterns = [ path('runcodex/', views.runcodex), path('testdb/', testdb.testdb), ]

添加数据

添加数据需要先创建对象，然后再执行 save 函数，相当于SQL中的INSERT：

HelloWorld/HelloWorld/testdb.py: 文件代码：

# -*- coding: utf-8 -*- from django.http import HttpResponse from TestModel.models import Test # 数据库操作 def testdb(request): test1 = Test(name='runcodex') test1.save() return HttpResponse("数据添加成功！")

访问 http://127.0.0.1:8000/testdb 就可以看到数据添加成功的提示。

输出结果如下：

获取数据

Django提供了多种方式来获取数据库的内容，如下代码所示：

HelloWorld/HelloWorld/testdb.py: 文件代码：

# -*- coding: utf-8 -*- from django.http import HttpResponse from TestModel.models import Test # 数据库操作 def testdb(request): # 初始化 response = "" response1 = "" # 通过objects这个模型管理器的all()获得所有数据行，相当于SQL中的SELECT * FROM list = Test.objects.all() # filter相当于SQL中的WHERE，可设置条件过滤结果 response2 = Test.objects.filter(id=1) # 获取单个对象 response3 = Test.objects.get(id=1) # 限制返回的数据相当于 SQL 中的 OFFSET 0 LIMIT 2; Test.objects.order_by('name')[0:2] #数据排序 Test.objects.order_by("id") # 上面的方法可以连锁使用 Test.objects.filter(name="runcodex").order_by("id") # 输出所有数据 for var in list: response1 += var.name + " " response = response1 return HttpResponse("" + response + "")

更新数据

修改数据可以使用 save() 或 update():

HelloWorld/HelloWorld/testdb.py: 文件代码：

# -*- coding: utf-8 -*- from django.http import HttpResponse from TestModel.models import Test # 数据库操作 def testdb(request): # 修改其中一个id=1的name字段，再save，相当于SQL中的UPDATE test1 = Test.objects.get(id=1) test1.name = 'Google' test1.save() # 另外一种方式 #Test.objects.filter(id=1).update(name='Google') # 修改所有的列 # Test.objects.all().update(name='Google') return HttpResponse("修改成功")

删除数据

删除数据库中的对象只需调用该对象的delete()方法即可：

HelloWorld/HelloWorld/testdb.py: 文件代码：

# -*- coding: utf-8 -*- from django.http import HttpResponse from TestModel.models import Test # 数据库操作 def testdb(request): # 删除id=1的数据 test1 = Test.objects.get(id=1) test1.delete() # 另外一种方式 # Test.objects.filter(id=1).delete() # 删除所有数据 # Test.objects.all().delete() return HttpResponse("删除成功")

对于死活装不上 mysqlclient 的，换链接库吧：

sudo apt install python-mysql.connector
pip install mysql-connector-python

修改 ENGINE 配置：

DATABASES = {
    'default': {
        'ENGINE': 'mysql.connector.django',  # 链接配置换成这个
        'NAME': 'test',
        'USER': 'test',
        'PASSWORD': 'test123',
        'HOST':'localhost',
        'PORT':'3306',
    }
}

致敬还在躺坑的萌新！

gmax2年前 (2018-10-23)

Windows 安装 mysqlclient 很多时候会报错，有人通过去这个网站：

https://www.lfd.uci.edu/~gohlke/pythonlibs/#mysqlclient

直接下载对应操作系统的 whl 文件来安装解决了问题：

pip install mysqlclient-1.3.13-cp37-cp37m-win_amd64.whl

如果连下载、安装都懒得去弄，现在可以安装 1.3.12（当前最新版本是 1.3.13）：

pip install mysqlclient==1.3.12

白虹李李2年前 (2018-11-13)

问题：使用Django连接数据库MySql8.0.13连接是报错

_mysql_exceptions.OperationalError: (2059, <NULL>)

原因：应该是新版本8.0 新的加密方式导致的问题。

解决：ALTER USER 'test'@'%' IDENTIFIED WITH mysql_native_password BY 'test';更改数据库密码的加密方式

mafx2年前 (2018-12-02)

$ python manage.py migrate   # 创建表结构

执行上面这句的时候，报错如下：

django.db.migrations.exceptions.MigrationSchemaMissing: Unable to create the django_migrations table ((1064, "You have an error in your SQL syntax; check the manual that corresponds to your MySQL server version for the right syntax to use near '(6) NOT NULL)' at line 1"))

解决办法：找到 python 目录下的 Lib\site-packages\django\db\backends\mysql\base.py，找到 'DateTimeField': 'datetime(6)', 把 datetime(6) 改成 datetime, 问题解决。

另一种解决办法：升级 MySQL，Django2.1 不支持 MySQL5.6 以下版本了，升级 MySQL 到 5.6 或更高版本即可。

hmildd2年前 (2018-12-06)

执行 python manage.py migrate 时出现错误：

django.db.utils.OperationalError: (2002, "Can't connect to MySQL server on 'localhost' (10061)")

仔细阅读发现需要安装本地 mysql，然后去官网下载，按照 mysql 教程安装，现在已经是 8.0.17 版本了，教程的安装设置步骤有所变化，搜索了了好多，发现这个可用：解决mysql8报错：ERROR 1410 (42000): You are not allowed to create a user with GRANT。设置成功后别忘了新建一个库，之后在执行那个命令就可以了。

刘罗锅上山10个月前 (09-28)

码农教程 -- 学习技术，成就梦想！

Django 模型

Django ORM

数据库配置

Django 如何使用 mysql 数据库

HelloWorld/HelloWorld/settings.py: 文件代码：

实例

定义模型

创建 APP

HelloWorld/TestModel/models.py: 文件代码：

常见报错信息

数据库操作

HelloWorld/HelloWorld/urls.py: 文件代码：

添加数据

HelloWorld/HelloWorld/testdb.py: 文件代码：

获取数据

HelloWorld/HelloWorld/testdb.py: 文件代码：

更新数据

HelloWorld/HelloWorld/testdb.py: 文件代码：

删除数据

HelloWorld/HelloWorld/testdb.py: 文件代码：

5 篇笔记写笔记

点我分享笔记

码农教程 -- 学习技术，成就梦想！

Django 模型

Django ORM

数据库配置

Django 如何使用 mysql 数据库

HelloWorld/HelloWorld/settings.py: 文件代码：

实例

定义模型

创建 APP

HelloWorld/TestModel/models.py: 文件代码：

常见报错信息

数据库操作

HelloWorld/HelloWorld/urls.py: 文件代码：

添加数据

HelloWorld/HelloWorld/testdb.py: 文件代码：

获取数据

HelloWorld/HelloWorld/testdb.py: 文件代码：

更新数据

HelloWorld/HelloWorld/testdb.py: 文件代码：

删除数据

HelloWorld/HelloWorld/testdb.py: 文件代码：

5 篇笔记 写笔记

点我分享笔记

微信关注

5 篇笔记写笔记