Django model 层之Models与Mysql数据库小结
by:授客 QQ：1033553122
测试环境：
Python版本：python-3.4.0.amd64
下载地址：https://www.python.org/downloads/release/python-340/
Win7 64位
Django 1.11.4
下载地址：https://www.djangoproject.com/download/
MySQL数据库为例,假设项目目录结构如下：
mysite/
myapp/
__init__.py
admin.py
apps.py
migrations/
__init__.py
models.py
tests.py
views.py
manage.py
mysite/
__init__.py
settings.py
urls.py
wsgi.py
配置数据库信息
打开项目根目录下，与项目同名的目录，编辑settings.py（例中mysite/mysite/settings.py文件），
找到以下代码
DATABASES = {
'default': {
……略
}
}
修改为以下内容：
DATABASES = {
'default': {
'ENGINE': 'django.db.backends.mysql',
'NAME': 'testdb',
'USER': 'testacc',
'PASSWORD': 'test1234',
'HOST': '192.168.1.102',
'PORT': '3306',
'OPTION':{
'init_command': 'SET default_storage_engine=INNODB'
}
}
}
说明：
ENGINE:默认为空。可选值：
'django.db.backends.postgresql'
'django.db.backends.mysql'
'django.db.backends.sqlite3'
'django.db.backends.oracle'
NAME：数据库名字。
如果使用SQLite,数据库文件将存放在电脑上，这种情况下，NAME应该为绝对路径，包含数据库文件的文件名。默认值如下，把数据库文件存放在项目根目录下。
DATABASES = {
'default': {
'ENGINE': 'django.db.backends.sqlite3',
'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
}
}
如果不使用SQLite，需要设置额外参数如USER, PASSWORD，HOST, PORT。
另外，确保提供的USER具备“create database”权限。
USER: 数据库用户名，默认为''
PASSWORD:连接数据库用户密码，默认为''
HOST: 数据库服务器主机地址，默认为''，代表localhost。支持tcp socket除外的其它socket连接方式，更多详情请查看官方文档。
PORT：数据库访问端口，默认为''，代表默认端口。
AUTOCOMMIT: 自动提交事务。默认为True。设置为False,则禁用Django 事务管理，采用自己实现的事务管理。
更多选项设置，请参考官方文档。
参考链接：
https://docs.djangoproject.com/en/1.11/ref/settings/#databases
建立表
编辑应用目录下的models.py文件(例中为 mysite/myapp/models.py)
from django.db import models
# Create your models here.
class Person(models.Model):
first_name = models.CharField(max_length=30)
last_name = models.CharField(max_length=30)
新增以上带背景色代码
first_name和last_name为model的field。每个field映射到一个数据库列。
以上Person model将创建如下表：
CREATE TABLE myapp_person (
"id" serial NOT NULL PRIMARY KEY,
"first_name" varchar(30) NOT NULL,
"last_name" varchar(30) NOT NULL);
注意：
1、如上，表名命名方式为应用名称_转为小写的model名称，我们可以通过Meta属性实现表名自定义，如下：
CREATE TABLE myapp_person (
"id" serial NOT NULL PRIMARY KEY,
"first_name" varchar(30) NOT NULL,
"last_name" varchar(30) NOT NULL);
class Meta:
db_table = 'tb_person'#数据库中创建的表名称即为 tb_person
verbose_name = '用户表'#表名称 #在admin站点中显示的名称
verbose_name_plural = verbose_name#显示的复数名称
2、自动为数据库增加 id 自增主键列。因为，默认的，Django为每个模块设置一个field:
id = models.AutoField(primary_key=True)
如果想自己指定一个自定义的主键列，则必须按上述设置，显示指定字段名称。总之，不管是默认设置还是显示设置，必须有一个自增主键列。
参考链接：
https://docs.djangoproject.com/en/1.11/topics/db/models/#automatic-primary-key-fields
class Book(models.Model):
book_name = models.CharField(max_length=30)
borrower = models.ForeignKey(Person, to_field='id', on_delete=models.CASCADE)
说明：mysql中，生成的外键列名称，会自动命名为：field_id，如上borrower field对应的mysql列为borrower_id
class Musician(models.Model):
auto_id = models.IntegerField(primary_key=True)
first_name = models.CharField(max_length=50)
last_name = models.CharField(max_length=50)
instrument = models.CharField(max_length=100)
last_update = models.DateField(auto_now=True, auto_now_add=True)
class Album(models.Model):
artist = models.ForeignKey(Musician, to_field='auto_id', on_delete=models.PROTECT)
name = models.CharField(max_length=100)
release_date = models.DateField()
num_stars = models.IntegerField()
Field 类型
AutoField
IntegerField，根据可获取的ID列值，自增
参数：verbose_name，个人推断，所有Field类型应该都有该参数，用于设置字段名称
BigAutoField
64位整型，类似AutoField，不同之处在于它可接收更大范围的数值：1 到9223372036854775807.
Django 1.10新增。
BigIntegerField
64位整型，类似IntegerField。不同之处在于它可接纳更大范围的数值：-9223372036854775808 到9223372036854775807。该field对应的默认组建：TextInput
BinaryField
用于存储原始二进制数据，仅支持字节。
BooleanField
true/false field.该field对应的默认表单组件：CheckboxInput。
如果需要接收null值，则使用NullBooleanField替代BooleanField。
如果未定义Field.default,那么BooleanField field默认值为None。
CharField
字符串类型。用于存储一定范围大小的字符串。针对大量文本，使用TextField。该field的默认组建为：TextInput
。
CharField有个额外的必填参数。CharField.max_length。设置可接纳的最大字符数。
DateField
日期类型。代表Python datetime.date实例。
class DateField(auto_now=False, auto_now_add=False, **options)[source]¶
可选参数：
DateField.auto_now
每次存储对象(仅针对调用save方法)时，自动设置该field的值为当前日期
注意：实践发现，调用Module_name.objects.Create()方法创建对象，auto_now()也起作用
DateField.auto_now_add
第一次创建对象时，自动设置field值为当前日期，所以，即便显示为该字段提供了值，也会自动忽视显示设定的值。
对于DateField：default=date.today - datetime.date.today()
对于DateTimeField: default=timezone.now - django.utils.timezone.now()
该field对应的默认表单组件为：TextInput。
注意：auto_now_add和auto_now两个参数不能同时使用。
TimeField
以python datetime.time实例表示的时间
可选参数：
DateField.auto_now
每次存储对象(仅针对调用save方法)时，自动设置该field的值为当前日期
DateField.auto_now_add
第一次创建对象时，自动设置field值为当前日期，所以，即便显示为该字段提供了值，也会自动忽视显示设定的值。
对于DateField：default=date.today - datetime.date.today()
对于DateTimeField: default=timezone.now - django.utils.timezone.now()
该field对应的默认表单组件为：TextInput。
DateTimeField
以python datetime.datetime实例表示的日期时间。
可选参数：
DateField.auto_now
每次存储对象(仅针对调用save方法)时，自动设置该field的值为当前日期时间
DateField.auto_now_add
第一次创建对象时，自动设置field值为当前日期时间，所以，即便显示为该字段提供了值，也会自动忽视显示
该field对应的默认表单组件为：TextInput。
DateTimeField字段的值，如果要保存为当前时间，可以通过timezone.now()快速获取当前时间进行赋值
>>> from django.utils import timezone
>>> update_time = timezone.now()
>>>user = User(username='test1', password='passwd123', email='email@163.com', update_time=update_time)
>>> user.save()
DecimalField
用Python Decimal实例表示的固定精度的数字。有两个必填参数：
DecimalField.max_digits
表示允许的最大值。必须大于等于decimal_spaces
DecimalField.decimal_places
设置精度位数。
比如field存储最大值不超过999,2位小数，设置如下：
models.DecimalField(..., max_digits=5, decimal_places=2)
该field对应的默认表单组件：当设置localize为False，则对应NumberInput,否则TextInput。
DurationField
存储以python timedelat表示的一段时间
EmailField
一个CharField，校验值是否是合法的email地址。使用EmailValidator校验输入值。
FileField
file-upload field。
注意：主键列不支持该类型。
更多详情参考官方文档。
FilePathField
一个CharField，可取值限制于系统上某个目录中的文件名
更多详情参考官方文档。
FloatField
python float实例表示的浮点数。
该field对应的默认表单组件：当设置localize为False，则对应NumberInput,否则TextInput。
ImageField
继承了FileField的所有属性和方法。校验上载对象是否是合法的图片。
更多详情参考官方文档。
IntegerField
整数。值从-2147483648 到2147483647，支持所有数据库。
该field对应的默认表单组件：当设置localize为False，则对应NumberInput,否则TextInput。
GenericIPAddressField
字符串格式（例如：192.0.2.30 or 2a02:42fe::4）表达的IPv4或IPv6地址，，针对IPv6，所有字符都会转为小写。
该field对应的默认表单组件：TextInput。
更多详情参考官方文档。
NullBooleanField
类似BooleanField,不同之处在于运行NULL值。等同BooleanField(...,null=True)。
该field对应的默认表单组件为NullBooleanSelect。
PositiveIntegerField
类似IntergerField,不同在于只接受正数，或者0.可取值范围：0 到2147483647
PositiveSmallIntegerField
类似PositiveIntegerField，可取值范围： 0 到 32767
SlugField
更多详情参考官方文档。
SmallIntegerField
类似IntegerField,取值范围：-32768 到 32767
TextField
大文本field。如果指定max_length属性，将作用于组件，但是不会是在数据库、model层起作用(If you specify a max_length attribute, it will be reflected in the Textarea widget of the auto-generated form field. However it is not enforced at the model or database level)。
该field对应的默认表单组件为：Textarea。
URLField
针对URL的CharField。可选参数：max_length，设置最大长度。默认200.
field对应的默认表单组件为：TextInput
UUIDField
存储全球唯一标识(universally unique identifier)。使用Python的UUID类。
对于主键AutoField来说，UUIDFeild是个很好的选择。但是数据库不会生成UUID，所以推荐使用default，如下：
import uuidfrom django.db import models
class MyUUIDModel(models.Model):
id = models.UUIDField(primary_key=True, default=uuid.uuid4, editable=False)
# other fields
参考链接：
https://docs.djangoproject.com/en/1.11/ref/models/fields/#model-field-types
常用Field option
null
如果设置null=True,保存数据到数据库时，把“空值”存储为NULL。默认null=False。
blank
如果设置blank=True, 允许Field值为空,字符型字段CharField和TextField是用空字符串来存储空值的。默认False
注意：
blank 是针对表单的，如果 blank=True，表示你的表单填写该字段的时候可以不填。
null 是针对数据库而言，如果 null=True, 表示数据库的该字段可以为空，那么在新建一个model对象的时候是不会报错的！！
choice
一个由多个2元组，组成的可迭代对象(如tuple、list)。
如果设置了该选项值，那么默认的表单组件将变为一个select box,而不是标准是text field，且将被限制从给定choice中选择choice。
choice 列表，形如以下：
YEAR_IN_SCHOOL_CHOICES = (
('FR', 'Freshman'),
('SO', 'Sophomore'),
('JR', 'Junior'),
('SR', 'Senior'),
('GR', 'Graduate'),)
每个元组中第一个元素，将被存储在数据库中，第二个元素用于默认表单组件展示
例：
from django.db import models
class Person(models.Model):
SHIRT_SIZES = (
('S', 'Small'),
('M', 'Medium'),
('L', 'Large'),
)
name = models.CharField(max_length=60)
shirt_size = models.CharField(max_length=1, choices=SHIRT_SIZES)
>>> p = Person(name="Fred Flintstone", shirt_size="L")
>>> p.save()
>>> p.shirt_size
'L'
>>> p.get_shirt_size_display()
'Large'
default
设置field的默认值。可以是可调用对象，也可以是某个值。如果是可调用对象，每次创建对象，都会被调用
help_text
同表单组件一起展示的帮助说明
primary_key
如果设置primary_key=True,那么该field将是model的主键
主键Field只读。如果修改某个已存在对象，主键列的值，并保存该对象，会在旧对象的基础上，重新构建一个对象。
例：
from django.db import models
class Fruit(models.Model):
name = models.CharField(max_length=100, primary_key=True)
>>> fruit = Fruit.objects.create(name='Apple')
>>> fruit.name = 'Pear'
>>> fruit.save()
>>> Fruit.objects.values_list('name', flat=True)
<QuerySet ['Apple', 'Pear']>
unique
如果设置unique=True,则该field不允许有重复值。
参考链接：
https://docs.djangoproject.com/en/1.11/topics/db/models/#field-options
关联关系
外键关联
假设artist model对应mysql表为 myapp_album, Musician model对应的mysql表为Musician表为myapp_musician,则以下field定义，会使两个mysql表建立外键关联关系。myapp_album.artist列引用mapp_musician.auto_id字段的值，即mapp_musician.auto_id为myapp_album表的外键。
class Album(models.Model):
artist = models.ForeignKey(Musician, to_field='auto_id', on_delete=models.PROTECT)
为方便理解，如上，暂时把Album、Musician Model称之为表，对应Model对象称之为表记录，存在外键关联的两个表，分别称之为参照表(如上的Album)，被参照表(如上的Musician)
假设Musician代码位于 Album代码之前，那么执行以上代码时将报错，因为那会还没有定义Musician，如果不调整代码顺序，即定义表的先后顺序，那怎么办呢？
解决方案：把关联表写成字符串形式，如下：
class Album(models.Model):
artist = models.ForeignKey('Musician', to_field='auto_id', on_delete=models.PROTECT)
自身关联
假设有表appame_resource，结构如下，其中parent的值如果不为NULL则为某条记录的id值
id name parent
1 xxx1 NULL
2 xxx2 1
这种情况则需要进行自身表关联设计，model设计如下：
class Resource(models.Model):
id = models.AutoField(primary_key=True, verbose_name='资源ID')
parent = models.ForeignKey('self', to_field='id', null=True, blank=True, on_delete=models.CASCADE)
name = models.CharField(max_length=20, verbose_name='资源名称')
null参数值说明：该值默认为False,设置为True则表示允许字段为null,空值将被存储为NULL
blank参数值说明：该值默认为False,设置为True则表示允许字段为空值
on_delete参数值说明：
2.0版本，该参数值必填，更早之前的版本则默认为CASCADE。
可选值：
CASCADE
级联删除。模拟sql约束 ON DELETE CASCADE。删除被参照表的某条表记录，同时级联删除参照表中，同待删除记录存在外键关联关系的记录。
PROTECT
删除被参照表中的某条表记录，如果参照表中，存在与该记录有外键关系的记录，则不让删除。
SET_NULL
删除被参照表的某条表记录，设置参照表中，同待删除记录存在外键关联的记录的外键列值为null。当且仅当设置了null=True选项时可用。
SET_DEFAULT
删除被参照表的某条表记录，设置参照表中，同待删除记录存在外键关联的记录的外键列值为默认值。必须为外键列设置默认值。
SET()
删除被参照表的某条表记录，设置参照表中，同待删除记录存在外键关联关系的记录的外键列值为传递给SET()的参数值，如果传递给SET()的参数值是可调用对象，则设置为调用可调用对象获取的结果。
官方例子：
from django.conf import settings
from django.contrib.auth import get_user_model
from django.db import models
def get_sentinel_user():
return get_user_model().objects.get_or_create(username='deleted')[0]
class MyModel(models.Model):
user = models.ForeignKey(
settings.AUTH_USER_MODEL,
on_delete=models.SET(get_sentinel_user),
)
DO_NOTHING
删除被参照表的某条表记录，不对参照表中同待删除记录存在外键关联的记录做任何处理。
参考链接：
https://docs.djangoproject.com/en/1.11/ref/models/fields/#foreignkey
参考链接：
https://docs.djangoproject.com/en/1.11/topics/db/models/#relationships
联合主键
例子：如下，希望project_id和user_id字段组合唯一
class APIProjectFacorites(models.Model):
id = models.AutoField(primary_key=True, verbose_name='自增id')
project_id = models.CharField(blank=True, null=True, max_length=300, verbose_name='项目id')
user_id = models.CharField(blank=True, null=True, max_length=15, verbose_name='用户id')
class Meta:
db_table = 'tb_api_project_facorities'
unique_together = ("project_id", "user_id")
verbose_name = 'API项目收藏表'
verbose_name_plural = verbose_name
组织models
1、如果manager.py 启动app，会创建包含一个models.py的文件。如果有许多model，可以按单个文件的方式组织model。新建models包来管理，具体方法如下：
然后移除models.py，并创建一个myapp/models目录，在该目录下新建__init__.py文件，用于存放models。
例：
假设在models目录下存在models文件，organic.py 和synthetic.py，编辑myapp/models/__init__.py，新增以下内容：
from .organic import Person
from .synthetic import Robot
参考链接：
https://docs.djangoproject.com/en/1.11/topics/db/models/
https://docs.djangoproject.com/en/1.11/