Django Models

Django Models的一些常用功能
参考https://www.cnblogs.com/system-public/p/6295349.html

Django shell 长时间没用导致 "Sql server gone away"
解决办法：

from django.db import connection
# connection.close()
# connection.connection.ping()
connection.connect()

Django配置了多个数据库

Model.objects.using("xxx").filter(...)

1. 字段

AutoField(Field)
       - int自增列，必须填入参数 primary_key=True
BigAutoField(AutoField)
       - bigint自增列，必须填入参数 primary_key=True

SmallIntegerField(IntegerField):
       - 小整数 -32768 ～ 32767
PositiveSmallIntegerField(PositiveIntegerRelDbTypeMixin, IntegerField)
       - 正小整数 0 ～ 32767
IntegerField(Field)
       - 整数列(有符号的) -2147483648 ～ 2147483647
PositiveIntegerField(PositiveIntegerRelDbTypeMixin, IntegerField)
       - 正整数 0 ～ 2147483647
BigIntegerField(IntegerField):
       - 长整型(有符号的) -9223372036854775808 ～ 9223372036854775807

BooleanField(Field)
       - 布尔值类型
NullBooleanField(Field):
       - 可以为空的布尔值

CharField(Field)
       - 字符类型
       - 必须提供max_length参数， max_length表示字符长度
TextField(Field)
       - 文本类型
EmailField(CharField)：
       - 字符串类型，Django Admin以及ModelForm中提供验证机制
URLField(CharField)
       - 字符串类型，Django Admin以及ModelForm中提供验证 URL
SlugField(CharField)
       - 字符串类型，Django Admin以及ModelForm中提供验证支持 字母、数字、下划线、连接符（减号）
UUIDField(Field)
       - 字符串类型，Django Admin以及ModelForm中提供对UUID格式的验证

FilePathField(Field)
       - 字符串，Django Admin以及ModelForm中提供读取文件夹下文件的功能
       - 参数：
               path,                      文件夹路径
               match=None,                正则匹配
               recursive=False,           递归下面的文件夹
               allow_files=True,          允许文件
               allow_folders=False,       允许文件夹
FileField(Field)
       - 字符串，路径保存在数据库，文件上传到指定目录
       - 参数：
           upload_to = ""      上传文件的保存路径
           storage = None      存储组件，默认django.core.files.storage.FileSystemStorage
ImageField(FileField)
       - 字符串，路径保存在数据库，文件上传到指定目录
       - 参数：
           upload_to = ""      上传文件的保存路径
           storage = None      存储组件，默认django.core.files.storage.FileSystemStorage
           width_field=None,   上传图片的高度保存的数据库字段名（字符串）
           height_field=None   上传图片的宽度保存的数据库字段名（字符串）

DateTimeField(DateField)
       - 日期+时间格式 YYYY-MM-DD HH:MM[:ss[.uuuuuu]][TZ]
DateField(DateTimeCheckMixin, Field)
       - 日期格式      YYYY-MM-DD
TimeField(DateTimeCheckMixin, Field)
       - 时间格式      HH:MM[:ss[.uuuuuu]]

FloatField(Field)
       - 浮点型
DecimalField(Field)
       - 10进制小数
       - 参数：
           max_digits，小数总长度
           decimal_places，小数位长度

BinaryField(Field)
       - 二进制类型

2. Meta

class A(models.Model):
    ...
    class Meta:
        managed = False                 # 定义模型但是migrate不操作
        verbose_name = "a"              # Admin显示名称
        verbose_name_plural = "a"       # 名称（复数）
        app_label = 'xxx'               # 所属app
        db_table = 'a'                  # db中建表名称（默认 app名称 + 下划线 + 类名）
        abstract = True                 # 抽象类，公共字段的提取，不会建表
        unique_together = (('name', 'last_name'))   # 两者组合保持唯一

3. 字段参数

db_column           数据库中字段的列名
default             数据库中字段的默认值
primary_key         数据库中字段是否为主键
db_index            数据库中字段是否可以建立索引
unique              数据库中字段是否可以建立唯一索引
unique_for_date     数据库中字段【日期】部分是否可以建立唯一索引
unique_for_month    数据库中字段【月】部分是否可以建立唯一索引
unique_for_year     数据库中字段【年】部分是否可以建立唯一索引
 
verbose_name        Admin中显示的字段名称
blank               Admin中是否允许用户输入为空
null                数据库中字段是否可以为空
editable            Admin中是否可以编辑
help_text           Admin中该字段的提示信息
choices             Admin中显示选择框的内容，用不变动的数据放在内存中从而避免跨表操作
                    如：gf = models.IntegerField(choices=[(0, '何穗'),(1, '大表姐'),],default=1)
 
error_messages      自定义错误信息（字典类型），从而定制想要显示的错误信息；
                    字典健：null, blank, invalid, invalid_choice, unique, and unique_for_date
                    如：{'null': "不能为空.", 'invalid': '格式错误'}
 
validators          自定义错误验证（列表类型），从而定制想要的验证规则
                    from django.core.validators import RegexValidator
                    from django.core.validators import EmailValidator,URLValidator,DecimalValidator,\
                    MaxLengthValidator,MinLengthValidator,MaxValueValidator,MinValueValidator
                    如：
                        test = models.CharField(
                            max_length=32,
                            error_messages={
                                'c1': '优先错信息1',
                                'c2': '优先错信息2',
                                'c3': '优先错信息3',
                            },
                            validators=[
                                RegexValidator(regex='root_\d+', message='错误了', code='c1'),
                                RegexValidator(regex='root_112233\d+', message='又错误了', code='c2'),
                                EmailValidator(message='又错误了', code='c3'), ]
                        )

4. 查找方式

# 正向
正常方式：
objs = Model.objects.all()
for obj in objs:
    ...
另一种方式
Model.objects.all().values('name', 'user__username')
# 反向
正常
objs = Model.objects.all()
for obj in objs:
    obj.x_set.all()      # x 为被外键表表名
另一种
Model.objects.all().values('username', 'xxx_name')

5. ForeignKey常用参数

外键为自己:
xxx = models.ForeignKey("self", to_field="pid", db_column="parent_pid", verbose_name="父订单", on_delete=models.DO_NOTHING, related_name='sons')
其中: 
self - 外键为本表
to_field - 外键关联到相应表的键名(默认是id)
db_column - 数据库中该列的名称

on_delete=None,             # 当删除关联表中的数据时，当前表与其关联的行的行为
   - models.CASCADE，删除关联数据，与之关联也删除
   - models.DO_NOTHING，删除关联数据，引发错误IntegrityError
   - models.PROTECT，删除关联数据，引发错误ProtectedError
   - models.SET_NULL，删除关联数据，与之关联的值设置为null（前提FK字段需要设置为可空）
   - models.SET_DEFAULT，删除关联数据，与之关联的值设置为默认值（前提FK字段需要设置默认值）
   - models.SET，删除关联数据，
      a. 与之关联的值设置为指定值，设置：models.SET(值)
      b. 与之关联的值设置为可执行对象的返回值，设置：models.SET(func)

related_name=None,          # 反向操作时，使用的字段名，用于代替 【表名_set】 如： obj.表名_set.all()
related_query_name=None,    # 反向操作时，使用的连接前缀，用于替换【表名】     如： models.UserGroup.objects.filter(表名__字段名=1).values('表名__字段名')
db_constraint=True          # 是否在数据库中创建外键约束
parent_link=False           # 在Admin中是否显示关联数据

6. ORM基础操作

6.1 CRUD

# 增
1. User.objects.create(...)
2. obj = User(a=xx, b=xx)
obj.save()
# 查
User.objects.get(...)
User.objects.filter(...)
User.objects.exclude(...)
User.objects.all()
# 增查
obj, status = User.objects.get_or_create(...)
# 删
User.objects.filter(...).delete()
# 改
1. User.objects.filter(...).update(a=xx)
2. obj = User.objects.filter(...).first()
    obj.a = xx
    obj.save()

6.2 filter / exclude进阶

条件选取querySet的时候，filter表示=，exclude表示!=。
querySet.distinct()  去重复
__exact        精确等于 like 'aaa'
__iexact    精确等于 忽略大小写 ilike 'aaa'
__contains    包含 like '%aaa%'
__icontains    包含 忽略大小写 ilike '%aaa%'，但是对于sqlite来说，contains的作用效果等同于icontains。
__gt    大于
__gte    大于等于
__lt    小于
__lte    小于等于
__in     存在于一个list范围内
__startswith   以...开头
__istartswith   以...开头 忽略大小写
__endswith     以...结尾
__iendswith    以...结尾，忽略大小写
__range    在...范围内  # __range=[1, 2]
__year       日期字段的年份
__month    日期字段的月份
__day        日期字段的日
__weekday
__hour
__minute
__second
__regex    正则
__iregex   正则不区分大小写
__isnull=True/False

6.3 进阶

1. 多条件filter
from django.db.models import Q
Model.objects.filter(Q(xxx=xxx) | Q(xx=xx))
2. 原数据基础上更新
from django.db.models import F
models.Tb1.objects.update(num=F('num')+1)
3. 原生sql
from django.db import connection, connections
cursor = connection.cursor()  # cursor = connections['default'].cursor()
cursor.execute("""SELECT * from auth_user where id = xxx""")
row = cursor.fetchone() / fetchall()
4. 聚合
4.1 aggregate
from django.db.models import Sum, Avg

total_info = xxx.objects.filter(...)
total_info.aggregate(Sum("box_amount"))["box_amount__sum"]
4.2 annotate
total_info.values("week").annotate(
  sum_box_amount=Sum("box_amount"),
  avg_box_purchase_rate=Avg("box_purchase_rate"),
  avg_sku_purchase_rate=Avg("sku_purchase_rate")
)

7. DateField相关处理

该字段在保存的时候应为python的日期格式，或字符串'2017-06-09'格式
格式转换函数：
import datetime
def parse_date(date_str):
    if not date_str:
        return None
    if "-" in date_str:
        if date_str.count("-") == 1:
            date = datetime.datetime.strptime(date_str, "%Y-%m")
        elif date_str.count("-") == 2:
            date = datetime.datetime.strptime(date_str, "%Y-%m-%d")
    elif "年" in date_str:
        if "日" in date_str:
            date = datetime.datetime.strptime(date_str, "%Y年%m月%d日")
        elif "月" in date_str:
            date = datetime.datetime.strptime(date_str, "%Y年%m月")
        else:
            date = datetime.datetime.strptime(date_str, "%Y年")
    elif date_str.isdigit():
        if len(date_str) == 4:
            date = datetime.datetime.strptime(date_str, "%Y")
        elif len(date_str) > 6:
            date = datetime.datetime.strptime(date_str, "%Y%m%d")
        else:
            date = datetime.datetime.strptime(date_str, "%Y%m")
    else:
        date = None
    return date

8. choice显示值

eg:
xxx = models.IntegerField（choices=XXX_CHOICES, default=x, verbose_name="x"）
obj.get_xxx_display()

9. 计算搜索

from django.db.models import Avg, Sum
areas = ShoppingMall.objects.filter(center_point__intersects=plate.boundary, category__in=[1,2,3,4,6,7,8]).aggregate(Sum("biz_areas"))["biz_areas__sum"]
计算filter后的biz_areas的和

10. QuerySet 不支持负索引

Person.objects.all()[:10] 切片操作，前10条
Person.objects.all()[-10:] 会报错！！！
 
# 1. 使用 reverse() 解决
Person.objects.all().reverse()[:2] # 最后两条
Person.objects.all().reverse()[0] # 最后一条
 
# 2. 使用 order_by，在栏目名（column name）前加一个负号
Author.objects.order_by('-id')[:20] # id最大的20条

11. QuerySet 重复的问题，使用 .distinct() 去重

一般的情况下，QuerySet 中不会出来重复的，重复是很罕见的，但是当跨越多张表进行检索后，结果并到一起，可能会出来重复的值（我最近就遇到过这样的问题）

qs1 = Pathway.objects.filter(label__name='x')
qs2 = Pathway.objects.filter(reaction__name='A + B >> C')
qs3 = Pathway.objects.filter(inputer__name='WeizhongTu')
 
# 合并到一起
qs = qs1 | qs2 | qs3
这个时候就有可能出现重复的
 
# 去重方法
qs = qs.distinct()

12. ManytoMany

image.png
最后编辑于 ：
©著作权归作者所有,转载或内容合作请联系作者
  • 人面猴
    序言：七十年代末，一起剥皮案震惊了整个滨河市，随后出现的几起案子，更是在滨河造成了极大的恐慌，老刑警刘岩，带你破解...
    沈念sama阅读 214,951评论 6赞 497
  • 死咒
    序言：滨河连续发生了三起死亡事件，死亡现场离奇诡异，居然都是意外死亡，警方通过查阅死者的电脑和手机，发现死者居然都...
    沈念sama阅读 91,606评论 3赞 389
  • 救了他两次的神仙让他今天三更去死
    文/潘晓璐 我一进店门，熙熙楼的掌柜王于贵愁眉苦脸地迎上来，“玉大人，你说我怎么就摊上这事。” “怎么了？”我有些...
    开封第一讲书人阅读 160,601评论 0赞 350
  • 道士缉凶录：失踪的卖姜人
    文/不坏的土叔 我叫张陵，是天一观的道长。 经常有香客问我，道长，这世上最难降的妖魔是什么？ 我笑而不...
    开封第一讲书人阅读 57,478评论 1赞 288
  • 港岛之恋（遗憾婚礼）
    正文 为了忘掉前任，我火速办了婚礼，结果婚礼上，老公的妹妹穿的比我还像新娘。我一直安慰自己，他们只是感情好，可当我...
    茶点故事阅读 66,565评论 6赞 386
  • 恶毒庶女顶嫁案：这布局不是一般人想出来的
    文/花漫 我一把揭开白布。 她就那样静静地躺着，像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上，一...
    开封第一讲书人阅读 50,587评论 1赞 293
  • 城市分裂传说
    那天，我揣着相机与录音，去河边找鬼。 笑死，一个胖子当着我的面吹牛，可吹牛的内容都是我干的。 我是一名探鬼主播，决...
    沈念sama阅读 39,590评论 3赞 414
  • 双鸳鸯连环套：你想象不到人心有多黑
    文/苍兰香墨 我猛地睁开眼，长吁一口气：“原来是场噩梦啊……” “哼！你这毒妇竟也来了？” 一声冷哼从身侧响起，我...
    开封第一讲书人阅读 38,337评论 0赞 270
  • 万荣杀人案实录
    序言：老挝万荣一对情侣失踪，失踪者是张志新（化名）和其女友刘颖，没想到半个月后，有当地人在树林里发现了一具尸体，经...
    沈念sama阅读 44,785评论 1赞 307
  • 护林员之死
    正文 独居荒郊野岭守林人离奇死亡，尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,096评论 2赞 330
  • 白月光启示录
    正文 我和宋清朗相恋三年，在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,273评论 1赞 344
  • 活死人
    序言：一个原本活蹦乱跳的男人离奇死亡，死状恐怖，灵堂内的尸体忽然破棺而出，到底是诈尸还是另有隐情，我是刑警宁泽，带...
    沈念sama阅读 34,935评论 5赞 339
  • 日本核电站爆炸内幕
    正文 年R本政府宣布，位于F岛的核电站，受9级特大地震影响，放射性物质发生泄漏。R本人自食恶果不足惜，却给世界环境...
    茶点故事阅读 40,578评论 3赞 322
  • 男人毒药：我在死后第九天来索命
    文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹，春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,199评论 0赞 21
  • 一桩弑父案，背后竟有这般阴谋
    文/苍兰香墨 我抬头看了看天上的太阳。三九已至，却和暖如春，着一层夹袄步出监牢的瞬间，已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,440评论 1赞 268
  • 情欲美人皮
    我被黑心中介骗来泰国打工， 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留，地道东北人。 一个月前我还...
    沈念sama阅读 47,163评论 2赞 366
  • 代替公主和亲
    正文 我出身青楼，却偏偏与公主长得像，于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子，可洞房花烛夜当晚...
    茶点故事阅读 44,133评论 2赞 352