专栏首页授客的专栏Django model 层之Models与Mysql数据库小结

Django model 层之Models与Mysql数据库小结

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/

本文参与腾讯云自媒体分享计划,欢迎正在阅读的你也加入,一起分享。

我来说两句

0 条评论
登录 后参与评论

相关文章

  • Mycat 中间件配置初探与入门操作

    Mycat-server-1.5.1-RELEASE-20161130213509-win.tar.gz

    授客
  • JavaScript 使用new关键字调用函数

    var friend=new Person("nike", 29, "software engineer");

    授客
  • 排错-lr回放错误Vuser failed to initialize extensi...解决方法

    lr回放错误:Vuser failed to initialize extension LrXml.dll解决方法

    授客
  • Django模型的Field Types总结

    Field Types 常用参数: null 如果设置为 True , Django 存放一个 NULL 到数据库字段。默认为 False。 blan...

    Ewdager
  • Django学习(第四天:ORM&Model)Modelsettingsmigrate和makemigrations

    罗罗攀
  • Django实战-调查问卷表设计优化

    Django网络应用开发的5项基础核心技术包括模型(Model)的设计,URL 的设计与配置,View(视图)的编写,Template(模板)的设计和Form(...

    小团子
  • 【Django】Django框架进阶详述(二)

    详见:https://docs.djangoproject.com/en/1.10/topics/forms/#looping-over-the-form-s-...

    魏晓蕾
  • mysql数据库中指定值在所有表中所有字段中的替换

    Java程序员也要new个对象
  • 解决更改AUTH_USER_MODEL后出现的问题

    使用django自带的 AbstractUser 扩展之后,更改AUTH_USER_MODEL = ‘users.UserProfile’属性后,进行数据库迁移...

    砸漏
  • 还在纠结垃圾分类问题?带你用Python感受ImageNet冠军模型SENet的强大

    本月1日起,上海正式开始了“史上最严“垃圾分类的规定,扔错垃圾最高可罚200元。全国其它46个城市也要陆续步入垃圾分类新时代。各种被垃圾分类逼疯的段子在社交媒体...

    AI科技大本营

扫码关注云+社区

领取腾讯云代金券