Django（ORM事务操作｜ORM常见字段类型｜ORM常见字段参数｜关系字段｜Meta元信息）

ORM事务操作

什么是事务？

事务是用户定义的一系列数据库操作，这些操作可以视为一个完整的逻辑处理工作单元。
要么全部执行，要么全部不执行，是不可分割的工作单元

事务的产生

	数据库中的数据是共享资源，因此数据库系统通常要支持多个用户的或不同应用程序的访问，并且各个访问进程都是独立执行的，这样就有可能出现并发存取数据的现象，为了避免数据库的不一致性这种处理机制称之为"并发控制"，其中事务就是为了保证数据的一致性而产生的的一种概念和手段（事务不是唯一手段）

事务的四大特征

为了保证数据库的正确性与一致性事务具有四个特征

1. 原子性（Atomicity）

   • 事务的原子性保证事务中包含的一组更新操作是原子的，不可分割的。不可分割是事务最小的工作单位
   • 所包含的操作被视为一个整体，执行过程中遵循着：要么全部执行，要么全部不执行，不存在一半执行一半未执行的情况

2. 一致性（Consistency）

   • 事务的一致性要求事务必须满足数据库的完整性约束
   • 且事务执行完毕后会将数据库由一个一致性的状态变为另一个一致性的状态，事务的一致性与原子性是密不可分的

3. 隔离性（Isolation）

   • 事务的隔离性要求事务之间是彼此独立的，隔离的，及一个事务的执行不可以被其他事务干扰

4. 持久性（Durability）

   • 事务的持续性也称为持久性，是指一个事务一旦提交，它对数据库的改变将是永久性的
   • 因为数据刷进了物理磁盘了，其他操作将不会对它产生任何影响

相关SQL关键字：start transaction; rollback; commit; savapoint;

相关重要概念：脏读、幻读、不可重复读、MVCC多版本控制

---

ORM中如何使用事务

django，ORM中提供了至少三种开启事务的方式

方式一：全局开启事务

	配置文件数据库（DATABASE）相关添加键值对   全局有效"ATOMIC_REQUESTS":True每次请求所涉及到的ORM操作同属于一个事务'如果过程中报错了，就会往回滚'

方式二：装饰器 局部有效

	from django.db import transaction # 引入事务模块@transaction.atomic  # 原子装饰器def index():passeg:from django.db import [e-mail] index():model.book.objects.create(title='简爱'，price='345',publish_id=1)hhshhsldlllds   # 报错>>>就会过滚return HttpResponse('添加成功')return 123  #在事务里面，这也算成功'''​ 装饰器针对的是视图函数，当视图函数需要设计ORM操作，如果函数从上往下执行，遇到报错会自动回滚到视图函数开始的状态。'''

方式三：with 上下文管理 局部有效

	from django.db import transactiondef reg():with transaction.atomic():pass  # 这下面看作是同一个事务处理，遇到报错就会回滚

---

ORM字段类型

名称	含义
AutoField()	Int自增列 必须填入参数 primary_key=True 当model中如果没有自增列 则自动会创建一个列名为id的列
CharField()	字符类型 必须提供max_length参数 max_length表示字符长度
IntegerField()	一个整数类型 范围在 -2147483648 to 2147483647 (一般不用它来存手机号(位数也不够) 直接用字符串存)
BigIntegerField()	长整型(有符号的) -9223372036854775808 ～ 9223372036854775807
DateField()	日期字段 日期格式 YYYY-MM-DD 相当于Python中的datetime.date()实例
DateTimeField()	日期时间字段 格式 YYYY-MM-DD HH:MM[:ss[.uuuuuu]][TZ] 相当于Python中datetime.datetime()实例
DecimalField()	10进制小数 参数 max_digits 小数总长度 decimal_places，小数位长度
EmailField()	字符串类型 Django Admin以及ModelForm中提供验证机制
BooleanField()	布尔值类型 传布尔值存数字0或1
TextField()	文本类型 存储大段文本
FileField()	字符串 路径保存在数据库 文件上传到指定目录 参数 upload_to = " " 上传文件的保存路径 storage = None 存储组件 默认django.core.files.storage.FileSystemStorage
ForeignKey()	外键类型在ORM中用来表示外键关联关系 一般把ForeignKey字段设置在 '一对多’中’多’的一方 ForeignKey可以和其他表做关联关系同时也可以和自身做关联关系
OneToOneField()	一对一字段 通常一对一字段用来扩展已有字段 通俗的说就是一个人的所有信息不是放在一张表里面的，简单的信息一张表，隐私的信息另一张表，之间通过一对一外键关联
ManyToManyField()	简单来说就是在多对多表关系并且这一张多对多的关系表是有Django自动帮你建的情况下 下面的方法才可使用create add set remove clear

需要说明的是，这些ORM字段并非与SQL字段一一对应，有些是封装了一些逻辑功能在字段的创建、存储过程中。

常用字段与不常用字段类型

AutoField(Field)
- int自增列，必须填入参数 primary_key=TrueBigAutoField(AutoField)
- bigint自增列，必须填入参数 primary_key=True注：当model中如果没有自增列，则自动会创建一个列名为id的列
from django.db import modelsclass UserInfo(models.Model):
# 自动创建一个列名为id的且为自增的整数列
username = models.CharField(max_length=32)class Group(models.Model):
# 自定义自增列
nid = models.AutoField(primary_key=True)
name = models.CharField(max_length=32)SmallIntegerField(IntegerField):
- 小整数 -32768 ～ 32767PositiveSmallIntegerField(PositiveIntegerRelDbTypeMixin, IntegerField)
- 正小整数 0 ～ 32767
IntegerField(Field)
- 整数列(有符号的) -2147483648 ～ 2147483647PositiveIntegerField(PositiveIntegerRelDbTypeMixin, IntegerField)
- 正整数 0 ～ 2147483647BigIntegerField(IntegerField):
- 长整型(有符号的) -9223372036854775808 ～ 9223372036854775807BooleanField(Field)
- 布尔值类型NullBooleanField(Field):
- 可以为空的布尔值CharField(Field)
- 字符类型
- 必须提供max_length参数， max_length表示字符长度TextField(Field)
- 文本类型EmailField(CharField)：
- 字符串类型，Django Admin以及ModelForm中提供验证机制IPAddressField(Field)
- 字符串类型，Django Admin以及ModelForm中提供验证 IPV4 机制GenericIPAddressField(Field)
- 字符串类型，Django Admin以及ModelForm中提供验证 Ipv4和Ipv6
- 参数：
protocol，用于指定Ipv4或Ipv6， 'both',"ipv4","ipv6"
unpack_ipv4， 如果指定为True，则输入::ffff:192.0.2.1时候，可解析为192.0.2.1，开启此功能，需要protocol="both"URLField(CharField)
- 字符串类型，Django Admin以及ModelForm中提供验证 URLSlugField(CharField)
- 字符串类型，Django Admin以及ModelForm中提供验证支持 字母、数字、下划线、连接符（减号）CommaSeparatedIntegerField(CharField)
- 字符串类型，格式必须为逗号分割的数字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.FileSystemStorageImageField(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-DDTimeField(DateTimeCheckMixin, Field)
- 时间格式      HH:MM[:ss[.uuuuuu]]DurationField(Field)
- 长整数，时间间隔，数据库中按照bigint存储，ORM中获取的值为datetime.timedelta类型FloatField(Field)
- 浮点型DecimalField(Field)
- 10进制小数
- 参数：
max_digits，小数总长度
decimal_places，小数位长度BinaryField(Field)
- 二进制类型

对应关系

    'AutoField': 'integer AUTO_INCREMENT','BigAutoField': 'bigint AUTO_INCREMENT','BinaryField': 'longblob','BooleanField': 'bool','CharField': 'varchar(%(max_length)s)','CommaSeparatedIntegerField': 'varchar(%(max_length)s)','DateField': 'date','DateTimeField': 'datetime','DecimalField': 'numeric(%(max_digits)s, %(decimal_places)s)','DurationField': 'bigint','FileField': 'varchar(%(max_length)s)','FilePathField': 'varchar(%(max_length)s)','FloatField': 'double precision','IntegerField': 'integer','BigIntegerField': 'bigint','IPAddressField': 'char(15)','GenericIPAddressField': 'char(39)','NullBooleanField': 'bool','OneToOneField': 'integer','PositiveIntegerField': 'integer UNSIGNED','PositiveSmallIntegerField': 'smallint UNSIGNED','SlugField': 'varchar(%(max_length)s)','SmallIntegerField': 'smallint','TextField': 'longtext','TimeField': 'time','UUIDField': 'char(32)',

ORM还支持用户自定义字段类型

	class FixedCharField(models.Field):  '类名随便取'"""自定义的char类型的字段类"""def __init__(self, max_length, *args, **kwargs):self.max_length = max_lengthsuper(FixedCharField, self).__init__(max_length=max_length, *args, **kwargs)'回调之前的init方法'def db_type(self, connection):"""限定生成数据库表的字段类型为char，长度为max_length指定的值"""return 'char(%s)' % self.max_lengthclass Class(models.Model):id = models.AutoField(primary_key=True)title = models.CharField(max_length=25)# 使用自定义的char类型的字段cname = FixedCharField(max_length=25)

---

ORM字段参数

任意字段都可以设置的参数

名称	含义
null	用于表示某个字段可以为空。设置方式：null = True
unique	用于表示该字段值在此表中必须是唯一的，建立唯一索引，设置方式：unique = True
db_index	将该字段设置为索引，设置方式：db_index = True
default	为该字段的默认值，设置方式：default = ‘默认值’
db_column	在数据库中的字段名称，默认和变量同名，设置方式：db_column=‘字段名’
primary_key	设置字段为主键，设置方式：primary_key = True。通常id字段为主键，且唯一主键

---

日期字段参数

名称	含义
unique_for_date	日期必须唯一
unique_for_month	月份必须唯一
unique_for_year	年份必须唯一
auto_now_add	增加记录时的时间
auto_now	更新当前记录的时间

---

用于Admin后台管理参数

名称	含义
verbose_name	Admin中显示的字段名称
blank	Admin中是否允许用户输入为空
editable	Admin中是否可以编辑
help_text	Admin中该字段的提示信息
choices	Admin中显示选择框的内容，用不变动的数据放在内存中从而避免跨表操作 （设置方式：choice=((1,‘男’),(2,‘女’),(0,‘未知’)) ）

---

其他参数

名称	含义
max_length	最大长度
verboses_name	别名
max_digits	数字中允许的最大的数字位数
decimal_places	数字的小数位数
unique=True	如果设置为unique=True 则该字段在此表中必须是唯一的

---

关系字段

表之间的关系由一对一、一对多、多对多来确定的

ForeignKey外键

通过外键来绑定各个表字段之间的关系

• to：关联哪张表、设置方式to = ‘关联表名’

• to_field：关联表的哪个字段（默认关联主键）

• related_name：反向查询时使用的字段名，用于代替原来反向查询的表名_set

• related_query_name：反向查询操作时 使用的连接前缀，用于代替表名。相当于给表设置了一个别名

on_delete参数设置的值

• models.CASCADE：删除关联数据，与之关联也删除

• models.DO_NOTHING：删除关联数据，引发错误IntegrityError

• models.PROTECT：删除关联数据，引发错误ProtectedError

• models.SET_NULL：删除关联数据，搭配null = True使用，使之关联的值为null

• models.SET_DEFAULT：删除关联数据，与之关联的值设置为默认值（前提FK字段需要设置默认值）

• models.SET：删除关联数据，设置为一个传递给SET()的值或者一个回调函数的返回值，注意大小写

db_constraint：保留跨表查询的方式，但是在table之间不建立外键关联（但是在Django内可以有一个关联状态，可以在admin里面看到），一般都设置为 False，减少过多的约束。此时on_delete参数需要设置为models.SET_NULL、blank=True、null=True允许字段为空，这样即使关联的外键数据被删除了，也只会将字段设置为null。

---

OneToOneField与ForeignKey的区别

OneToOneField用于一对一关系的表之间进行关联。

根据Django官方文档介绍：

A one-to-one relationship. Conceptually, this is similar to a ForeignKey with unique=True, but the “reverse” side of the relation will directly return a single object.

OneToOneField与ForeignKey加上unique=True效果基本一样，但是用OneToOneField反向关联会直接返回对象。

相反地，使用ForeignKey, 反向关联后会返回QuerySet。

例如：Book表通过ForenignKey与Publish表建立了外键

	obj = models.Publish.objects.filter(pk=1).first()print(obj.book_set.all()) # 通过ForenignKey进行关联所以反向查询必须要加表名小写_set.all()执行结果：拿到的是一个QuerySet对象<QuerySet [<Book: Book object (1)>, <Book: Book object (2)>]>

Author表通过OneToOneField与AuthorDeatil表建立了外键

	obj = models.AuthorDeatil.objects.filter(pk=1).first()print(obj.author) # 通过OneToOneField进行关联的反向查询不需要_set.all()执行结果：Author object (1)

---

多对多关系建立的方式

两张表之间多对多的关系通常需要借助第三张表来存储，这样也更利于我们查询。而第三张表的建立有三种方式：

• 第一种：自动创建（常用：但是创建出来的第三张表没有其它字段，只存有这两张表的主键相互对应关系）
• 第二种：半手动创建（比较常用：第三张表我们可以建立其它字段，但也不影响两张表的关联）
• 第三种：完全手动建立第三张表。

第一种方式：通过ORM自带的ManyToManyField自动创建第三张表

	class Book(models.Model):title = models.CharField(max_length=32, verbose_name="书名")class Author(models.Model):name = models.CharField(max_length=32, verbose_name="作者姓名")books = models.ManyToManyField(to="Book", related_name="authors")# 每次可以将Author表与Book表对应关系的主键值存储到第三张表

这种建立第三张表具备多个：多对多关系操作API

author_obj.books.add()：括号内填写与作者关联的书籍对象 或者 书籍的主键值
author_obj.books.set()：清空该作者原来关联的书籍，传入一个可迭代对象（里面可以包含一个或多个书籍对象 或者 书籍主键值）
author_obj.books.clear()：清空该作者关联的书籍
author_obj.books.remove()：移除该作者关联的某个书籍

---

第二种方式：自己创建第三张表，并通过ManyToManyField指定关联

	class Book(models.Model):title = models.CharField(max_length=32, verbose_name="书名")class Author(models.Model):name = models.CharField(max_length=32, verbose_name="作者姓名")books = models.ManyToManyField(to="Book", through="Author2Book", through_fields=("author", "book"))# through_fields 元组的第一个值是ManyToManyField所在的表去中间表通过那个字段，就写在第一个位置。我们要通过author字段去中间表，因为authorclass Author2Book(models.Model):author = models.ForeignKey(to="Author")book = models.ForeignKey(to="Book")

through：指定我们手动创建的中间表

through_fields：指定关联字段，设置方式通过元组，值也就是关联第三张表的哪几个字段，注意先后顺序：如果book写在前面则表示我们从Author表到中间表要通过book字段，那么就会乱套了

---

第三种方式：自己创建第三张表，分别通过外键关联书和作者

	class Book1(models.Model):title = models.CharField(max_length=32, verbose_name="书名")class Author1(models.Model):name = models.CharField(max_length=32, verbose_name="作者姓名")class Author2Book1(models.Model):author = models.ForeignKey(to="Author")book = models.ForeignKey(to="Book")

这种方式创建的多对多关系很多API操作都用不了，需要手动指定，如果要跨表查询将不能通过obj.表名小写或者obj.表名小写_set.all()，而是每次都要通过中间表来实现。

---

ORM中执行SQL语句

在Django的ORM中我们也是可以使用原生SQL来进行操作的，其实我们并不能完全依赖于ORM框架来提供给我们操作数据库的便利，因为ORM在很多语言中使用形式都会有些不同，而SQL语句则是不变的。

实例：我们不需要管是基于什么对象来执行SQL语句，查出什么字段就可以直接使用

	res = models.Author.objects.raw('select * from app01_book where id > 1')for book in res:print(book.name,book.price,book.publish_time)执行结果:Python爬虫从入门到入狱 666.5 2023-11-24MySQL从入门到删库跑路 880.0 2023-10-24

总结：执行原生sql，跟对象类型无关了，查出什么字段，可以直接使用该字段。

ps：但是基于的不同对象执行SQL语句，得到的结果也会是不同的，有些字段数据还是用不了

Meta元信息

Meta是Django模型类里面的一个内部类，它用于定义一些Django模型类的行为特性。

	定义方式：class Author(models.Model):class Meta:pass

通常在里面定义变量来代表选项，而可用的选项大致包含以下几类：
1、db_table
自定义表名（通常表名都是由Django帮助我们创建的，且是由：项目_类名组合的）

---

2、index_together
为多个字段建立联合索引，设置方式：index_together = (‘name’,‘age’)

---

3、unique_together
当需要通过两个字段保持模型唯一性时使用，假设有一个 User 类，我们希望 User 的 username 和 email 两个属性的组合必须是唯一的，那么需要设置为：

	unique_together = (("username", "email"),)

当某个一行记录：username='jack'、email='[e-mail]，那么其它行就不能同时这两个字段值都设置的和那一行一样。

unique_together 的值是一个元组的元组。为了方便起见，处理单一字段的集合时unique_together 可以是一维的元组

	unique_together = ("driver", "restaurant")

这样就确保了driver与restaurant字段值是唯一的

---

4、ordering
根据哪个字段排序，设置方式：ordering = (‘id’,)

---

可配置参数

属性	描述
db_table = ‘xxx’	修改表名为xxx
ordering = ‘xxx’ 按照指定字段xxx排序
verbose_name = ‘xxx’	给模型类指定一个直观可读的信息xxx
verbose_name_plural = verbose_name	设置verbose_name的复数
abstract = True	设置模型类为一个基类（不会生成为表，只作为继承使用）
permissions = ((‘定义好的权限’, ‘权限说明’),)	给数据库的表设置额外的权限
managed = False	是否按照django既定的规则来管理模型类
unique_together = (‘address’, ‘note’)	联合唯一键，约束
app_label = ‘xxx’	定义模型类属于哪一个应用
db_tablespace	定义数据库表空间的名字