Django ORM 操作
知识预览
ORM
映射关系：
表名 <－－－－－－－> 类名
字段 <－－－－－－－> 属性
表记录 <－－－－－－－>类实例对象
创建表(建立模型)
实例：我们来假定下面这些概念，字段和关系
作者模型：一个作者有姓名和年龄。
作者详细模型：把作者的详情放到详情表，包含生日，手机号，家庭住址等信息。作者详情模型和作者模型之间是一对一的关系（one-to-one）
出版商模型：出版商有名称，所在城市以及email。
书籍模型： 书籍有书名和出版日期，一本书可能会有多个作者，一个作者也可以写多本书，所以作者和书籍的关系就是多对多的关联关系(many-to-many);一本书只应该由一个出版商出版，所以出版商和书籍是一对多关联关系(one-to-many)。
模型建立如下：
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
|
class Author(models.Model): nid = models.AutoField(primary_key=True) name=models.CharField( max_length=32) age=models.IntegerField() # 与AuthorDetail建立一对一的关系 authorDetail=models.OneToOneField(to="AuthorDetail")class AuthorDetail(models.Model): nid = models.AutoField(primary_key=True) birthday=models.DateField() telephone=models.BigIntegerField() addr=models.CharField( max_length=64) class Publish(models.Model): nid = models.AutoField(primary_key=True) name=models.CharField( max_length=32) city=models.CharField( max_length=32) email=models.EmailField()class Book(models.Model): nid = models.AutoField(primary_key=True) title = models.CharField( max_length=32) publishDate=models.DateField() price=models.DecimalField(max_digits=5,decimal_places=2) keepNum=models.IntegerField()<br> commentNum=models.IntegerField() # 与Publish建立一对多的关系,外键字段建立在多的一方 publish=models.ForeignKey(to="Publish",to_field="nid") # 与Author表建立多对多的关系,ManyToManyField可以建在两个模型中的任意一个，自动创建第三张表 authors=models.ManyToManyField(to=\'Author\') |
通过logging可以查看翻译成的sql语句
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
|
LOGGING = { \'version\': 1, \'disable_existing_loggers\': False, \'handlers\': { \'console\':{ \'level\':\'DEBUG\', \'class\':\'logging.StreamHandler\', }, }, \'loggers\': { \'django.db.backends\': { \'handlers\': [\'console\'], \'propagate\': True, \'level\':\'DEBUG\', }, }} |
注意事项：
1、 表的名称myapp_modelName，是根据 模型中的元数据自动生成的，也可以覆写为别的名称
2、id 字段是自动添加的
3、对于外键字段，Django 会在字段名上添加"_id" 来创建数据库中的列名
4、这个例子中的CREATE TABLE SQL 语句使用PostgreSQL 语法格式，要注意的是Django 会根据settings 中指定的数据库类型来使用相应的SQL 语句。
5、定义好模型之后，你需要告诉Django _使用_这些模型。你要做的就是修改配置文件中的INSTALL_APPSZ中设置，在其中添加models.py所在应用的名称。
6、外键字段 ForeignKey 有一个 null=True 的设置(它允许外键接受空值 NULL)，你可以赋给它空值 None 。
字段选项
每个字段有一些特有的参数，例如，CharField需要max_length参数来指定VARCHAR数据库字段的大小。还有一些适用于所有字段的通用参数。 这些参数在文档中有详细定义，这里我们只简单介绍一些最常用的：
(1)null 如果为True，Django 将用NULL 来在数据库中存储空值。 默认值是 False. (1)blank 如果为True，该字段允许不填。默认为False。 要注意，这与 null 不同。null纯粹是数据库范畴的，而 blank 是数据验证范畴的。 如果一个字段的blank=True，表单的验证将允许该字段是空值。如果字段的blank=False，该字段就是必填的。 (2)default 字段的默认值。可以是一个值或者可调用对象。如果可调用 ，每有新对象被创建它都会被调用。 (3)primary_key 如果为True，那么这个字段就是模型的主键。如果你没有指定任何一个字段的primary_key=True， Django 就会自动添加一个IntegerField字段做为主键，所以除非你想覆盖默认的主键行为， 否则没必要设置任何一个字段的primary_key=True。 (4)unique 如果该值设置为 True, 这个数据字段的值在整张表中必须是唯一的 (5)choices 由二元组组成的一个可迭代对象（例如，列表或元组），用来给字段提供选择项。 如果设置了choices ，默认的表单将是一个选择框而不是标准的文本框，而且这个选择框的选项就是choices 中的选项。 这是一个关于 choices 列表的例子： YEAR_IN_SCHOOL_CHOICES = ( (\'FR\', \'Freshman\'), (\'SO\', \'Sophomore\'), (\'JR\', \'Junior\'), (\'SR\', \'Senior\'), (\'GR\', \'Graduate\'), ) 每个元组中的第一个元素，是存储在数据库中的值；第二个元素是在管理界面或 ModelChoiceField 中用作显示的内容。 在一个给定的 model 类的实例中，想得到某个 choices 字段的显示值，就调用 get_FOO_display 方法(这里的 FOO 就是 choices 字段的名称 )。例如： 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\'
更多详见模型字段参考
一旦你建立好数据模型之后，django会自动生成一套数据库抽象的API，可以让你执行关于表记录的增删改查的操作。
添加表记录
普通字段
|
1
2
3
|
方式1publish_obj=Publish(name="人民出版社",city="北京",email="renMin@163.com")publish_obj.save() # 将数据保存到数据库 |
|
1
2
|
方式2 <br>返回值publish_obj是添加的记录对象publish_obj=Publish.objects.create(name="人民出版社",city="北京",email="renMin@163.com") |
外键字段
|
1
2
3
4
5
6
|
方式1: publish_obj=Publish.objects.get(nid=1) Book.objects.create(title="金瓶眉",publishDate="2012-12-12",price=665,pageNum=334,publish=publish_obj)方式2: Book.objects.create(title="金瓶眉",publishDate="2012-12-12",price=665,pageNum=334,publish_id=1) |
关键点：book_obj.publish是什么？
多对多字段
|
1
2
3
4
5
6
7
8
|
book_obj=Book.objects.create(title="追风筝的人",publishDate="2012-11-12",price=69,pageNum=314,publish_id=1)author_yuan=Author.objects.create(name="yuan",age=23,authorDetail_id=1)author_egon=Author.objects.create(name="egon",age=32,authorDetail_id=2)book_obj.authors.add(author_egon,author_yuan) # 将某个特定的 model 对象添加到被关联对象集合中。 ======= book_obj.authors.add(*[])book_obj.authors.create() #创建并保存一个新对象，然后将这个对象加被关联对象的集合中，然后返回这个新对象。 |
关键点：book_obj.authors是什么？
解除关系：
|
1
2
|
book_obj.authors.remove() # 将某个特定的对象从被关联对象集合中去除。 ====== book_obj.authors.remove(*[])book_obj.authors.clear() #清空被关联对象集合。 |
class RelatedManager
"关联管理器"是在一对多或者多对多的关联上下文中使用的管理器。它存在于下面两种情况：
ForeignKey关系的“另一边”。像这样：
|
1
2
3
4
5
6
7
8
|
from django.db import modelsclass Reporter(models.Model): # ... passclass Article(models.Model): reporter = models.ForeignKey(Reporter) |
在上面的例子中，管理器reporter.article_set拥有下面的方法。
ManyToManyField关系的两边：
|
1
2
3
4
5
6
|
class Topping(models.Model): # ... passclass Pizza(models.Model): toppings = models.ManyToManyField(Topping) |
这个例子中，topping.pizza_set 和pizza.toppings都拥有下面的方法。
add(obj1[, obj2, ...])
把指定的模型对象添加到关联对象集中。
例如：
|
1
2
3
|
>>> b = Blog.objects.get(id=1)>>> e = Entry.objects.get(id=234)>>> b.entry_set.add(e) # Associates Entry e with Blog b. |
在上面的例子中，对于ForeignKey关系，e.save()由关联管理器调用，执行更新操作。然而，在多对多关系中使用add()并不会调用任何 save()方法，而是由QuerySet.bulk_create()创建关系。
create(**kwargs)
创建一个新的对象，保存对象，并将它添加到关联对象集之中。返回新创建的对象：
|
1
2
3
4
5
6
7
8
|
>>> b = Blog.objects.get(id=1)>>> e = b.entry_set.create(... headline=\'Hello\',... body_text=\'Hi\',... pub_date=datetime.date(2005, 1, 1)... )# No need to call e.save() at this point -- it\'s already been saved. |
这完全等价于（不过更加简洁于）：
|
1
2
3
4
5
6
7
8
|
>>> b = Blog.objects.get(id=1)>>> e = Entry(... blog=b,... headline=\'Hello\',... body_text=\'Hi\',... pub_date=datetime.date(2005, 1, 1)... )>>> e.save(force_insert=True) |
要注意我们并不需要指定模型中用于定义关系的关键词参数。在上面的例子中，我们并没有传入blog参数给create()。Django会明白新的 Entry对象blog 应该添加到b中。
remove(obj1[, obj2, ...])
从关联对象集中移除执行的模型对象：
|
1
2
3
|
>>> b = Blog.objects.get(id=1)>>> e = Entry.objects.get(id=234)>>> b.entry_set.remove(e) # Disassociates Entry e from Blog b. |
对于ForeignKey对象，这个方法仅在null=True时存在。
clear()
从关联对象集中移除一切对象。
|
1
2
|
>>> b = Blog.objects.get(id=1)>>> b.entry_set.clear() |
注意这样不会删除对象 —— 只会删除他们之间的关联。
就像 remove() 方法一样，clear()只能在 null=True的ForeignKey上被调用。
注意
对于所有类型的关联字段，add()、create()、remove()和clear()都会马上更新数据库。换句话说，在关联的任何一端，都不需要再调用save()方法。
直接赋值：
通过赋值一个新的可迭代的对象，关联对象集可以被整体替换掉。
|
1
2
|
>>> new_list = [obj1, obj2, obj3]>>> e.related_set = new_list |
如果外键关系满足null=True，关联管理器会在添加new_list中的内容之前，首先调用clear()方法来解除关联集中一切已存在对象的关联。否则， new_list中的对象会在已存在的关联的基础上被添加。
查询表记录
查询相关API
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
|
<1> all(): 查询所有结果<2> filter(**kwargs): 它包含了与所给筛选条件相匹配的对象<3> get(**kwargs): 返回与所给筛选条件相匹配的对象，返回结果有且只有一个， 如果符合筛选条件的对象超过一个或者没有都会抛出错误。<5> exclude(**kwargs): 它包含了与所给筛选条件不匹配的对象<4> values(*field): 返回一个ValueQuerySet——一个特殊的QuerySet，运行后得到的并不是一系列 model的实例化对象，而是一个可迭代的字典序列<9> values_list(*field): 它与values()非常相似，它返回的是一个元组序列，values返回的是一个字典序列<6> order_by(*field): 对查询结果排序<7> reverse(): 对查询结果反向排序<8> distinct(): 从返回结果中剔除重复纪录<10> count(): 返回数据库中匹配查询(QuerySet)的对象数量。<11> first(): 返回第一条记录<12> last(): 返回最后一条记录<13> exists(): 如果QuerySet包含数据，就返回True，否则返回False |
注意：一定区分object与querySet的区别 ！！！
双下划线之单表查询
|
1
2
3
4
5
6
7
8
9
10
11
|
models.Tb1.objects.filter(id__lt=10, id__gt=1) # 获取id大于1 且 小于10的值models.Tb1.objects.filter(id__in=[11, 22, 33]) # 获取id等于11、22、33的数据models.Tb1.objects.exclude(id__in=[11, 22, 33]) # not inmodels.Tb1.objects.filter(name__contains="ven")models.Tb1.objects.filter(name__icontains="ven") # icontains大小写不敏感models.Tb1.objects.filter(id__range=[1, 2]) # 范围bettwen andstartswith，istartswith, endswith, iendswith |
基于对象的跨表查询
一对多查询（Publish 与 Book）
正向查询(按字段：publish)：
|
1
2
|
# 查询nid=1的书籍的出版社所在的城市<br>book_obj=Book.objects.get(nid=1)<br>print(book_obj.publish.city) # book_obj.publish 是nid=1的书籍对象关联的出版社对象 |
反向查询(按表名：book_set)：
|
1
2
3
4
5
6
7
8
|
# 查询 人民出版社出版过的所有书籍 publish=Publish.objects.get(name="人民出版社") book_list=publish.book_set.all() # 与人民出版社关联的所有书籍对象集合 for book_obj in book_list: print(book_obj.title) |
一对一查询(Author 与 AuthorDetail)
正向查询(按字段：authorDetail)：
|
1
2
|