Django model 层之ModelsMysql数据库小结

 

测试环境:

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 protected]', 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

删除被参照表的某条表记录 ,不对参照表中同待删除记录存在外键关联的记录做任何处理 。

 

 

&

本文版权归QU快排Www.seoGurubLog.com 所有,如有转发请注明来出,竞价开户托管,seo优化请联系QQ▲61910465