Django model class

Websites, IT & Software
#1

模型定义参考

字段

对字段名称的限制

  • 字段名不能是Python的保留字，否则会导致语法错误
  • 字段名不能有多个连续下划线，否则影响ORM查询操作

Django模型字段类

字段类 说明
AutoField 自增ID字段
BigIntegerField 64位有符号整数
BinaryField 存储二进制数据的字段，对应Python的bytes类型
BooleanField 存储True或False
CharField 长度较小的字符串
DateField 存储日期，有auto_now和auto_now_add属性
DateTimeField 存储日期和日期，两个附加属性同上
DecimalField 存储固定精度小数，有max_digits（有效位数）和decimal_places（小数点后面）两个必要的参数
DurationField 存储时间跨度
EmailField 与CharField相同，可以用EmailValidator验证
FileField 文件上传字段
FloatField 存储浮点数
ImageField 其他同FileFiled，要验证上传的是不是有效图像
IntegerField 存储32位有符号整数。
GenericIPAddressField 存储IPv4或IPv6地址
NullBooleanField 存储True、False或null值
PositiveIntegerField 存储无符号整数（只能存储正数）
SlugField 存储slug（简短标注）
SmallIntegerField 存储16位有符号整数
TextField 存储数据量较大的文本
TimeField 存储时间
URLField 存储URL的CharField
UUIDField 存储全局唯一标识符
字段属性

通用字段属性

选项 说明
null 数据库中对应的字段是否允许为NULL，默认为False
blank 后台模型管理验证数据时，是否允许为NULL，默认为False
choices 设定字段的选项，各元组中的第一个值是设置在模型上的值，第二值是人类可读的值
db_column 字段对应到数据库表中的列名，未指定时直接使用字段的名称
db_index 设置为True时将在该字段创建索引
db_tablespace 为有索引的字段设置使用的表空间，默认为DEFAULT_INDEX_TABLESPACE
default 字段的默认值
editable 字段在后台模型管理或ModelForm中是否显示，默认为True
error_messages 设定字段抛出异常时的默认消息的字典，其中的键包括null、blank、invalid、invalid_choice、unique和unique_for_date
help_text 表单小组件旁边显示的额外的帮助文本。
primary_key 将字段指定为模型的主键，未指定时会自动添加AutoField用于主键，只读。
unique 设置为True时，表中字段的值必须是唯一的
verbose_name 字段在后台模型管理显示的名称，未指定时使用字段的名称

ForeignKey属性

  1. limit_choices_to：值是一个Q对象或返回一个Q对象，用于限制后台显示哪些对象。
  2. related_name：用于获取关联对象的关联管理器对象（反向查询），如果不允许反向，该属性应该被设置为'+'，或者以'+'结尾。
  3. to_field：指定关联的字段，默认关联对象的主键字段。
  4. db_constraint：是否为外键创建约束，默认值为True。
  5. on_delete：外键关联的对象被删除时对应的动作，可取的值包括django.db.models中定义的：
  • CASCADE：级联删除。
  • PROTECT：抛出ProtectedError异常，阻止删除引用的对象。
  • SET_NULL：把外键设置为null，当null属性被设置为True时才能这么做。
  • SET_DEFAULT：把外键设置为默认值，提供了默认值才能这么做。

ManyToManyField属性

  1. symmetrical：是否建立对称的多对多关系。
  2. through：指定维持多对多关系的中间表的Django模型。
  3. throughfields：定义了中间模型时可以指定建立多对多关系的字段。
  4. db_table：指定维持多对多关系的中间表的表名。
模型元数据选项
选项 说明
abstract 设置为True时模型是抽象父类
app_label 如果定义模型的应用不在INSTALLED_APPS中可以用该属性指定
db_table 模型使用的数据表名称
db_tablespace 模型使用的数据表空间
default_related_name 关联对象回指这个模型时默认使用的名称，默认为<model_name>_set
get_latest_by 模型中可排序字段的名称。
managed 设置为True时，Django在迁移中创建数据表并在执行flush管理命令时把表移除
order_with_respect_to 标记对象为可排序的
ordering 对象的默认排序
permissions 创建对象时写入权限表的额外权限
default_permissions 默认为('add', 'change', 'delete')
unique_together 设定组合在一起时必须独一无二的字段名
index_together 设定一起建立索引的多个字段名
verbose_name 为对象设定人类可读的名称
verbose_name_plural 设定对象的复数名称

查询参考

按字段查找可以用的条件
  1. exact / iexact：精确匹配/忽略大小写的精确匹配查询
  2. contains / icontains / startswith / istartswith / endswith / iendswith：基于like的模糊查询
  3. in ：集合运算
  4. gt / gte / lt / lte：大于/大于等于/小于/小于等于关系运算
  5. range：指定范围查询（SQL中的between…and…）
  6. year / month / day / week_day / hour / minute / second：查询时间日期
  7. isnull：查询空值（True）或非空值（False）
  8. search：基于全文索引的全文检索（一般很少使用）
  9. regex / iregex：基于正则表达式的模糊匹配查询