Python Django QuerySet.order_by用法及代码示例

本文介绍 django.db.models.query.QuerySet.order_by 的用法。

声明

order_by(*fields)

默认情况下，QuerySet 返回的结果由模型的 Meta 中的 ordering 选项给出的排序元组排序。您可以使用order_by 方法在每个QuerySet 的基础上覆盖它。

例子：

Entry.objects.filter(pub_date__year=2005).order_by('-pub_date', 'headline')

上面的结果将按 pub_date 降序排列，然后按 headline 升序排列。 "-pub_date"前面的负号表示descending顺序。升序是隐含的。要随机排序，请使用 "?" ，如下所示：

Entry.objects.order_by('?')

注意：order_by('?') 查询可能既昂贵又缓慢，具体取决于您使用的数据库后端。

要按不同模型中的字段排序，请使用与跨模型关系查询时相同的语法。也就是说，字段的名称后跟双下划线 (__)，然后是新模型中的字段名称，依此类推，以加入任意数量的模型。例如：

Entry.objects.order_by('blog__name', 'headline')

如果您尝试按与另一个模型相关的字段排序，Django 将使用相关模型的默认排序，或者如果没有指定 Meta.ordering ，则按相关模型的主键排序。例如，由于 Blog 模型没有指定默认排序：

Entry.objects.order_by('blog')

…等同于：

Entry.objects.order_by('blog__id')

如果 Blog 有 ordering = ['name'] ，那么第一个查询集将等同于：

Entry.objects.order_by('blog__name')

您还可以通过在表达式上调用 asc() 或 desc() 来按查询表达式排序：

Entry.objects.order_by(Coalesce('summary', 'headline').desc())

asc() 和 desc() 具有控制空值排序方式的参数( nulls_first 和 nulls_last )。

如果您还使用 distinct() ，则在相关模型中按字段排序时要小心。请参阅 distinct() 中的注释，了解相关模型排序如何改变预期结果。

class Event(Model):
   parent = models.ForeignKey(
       'self',
       on_delete=models.CASCADE,
       related_name='children',
   )
   date = models.DateField()

Event.objects.order_by('children__date')

没有办法指定排序是否应该区分大小写。关于区分大小写，Django 将对结果进行排序，但是您的数据库后端通常会对其进行排序。

您可以使用 Lower 将字段转换为小写，这将实现 case-consistent 排序：

Entry.objects.order_by(Lower('headline').desc())

如果您不希望对查询应用任何排序，甚至是默认排序，请不带参数调用 order_by() 。

您可以通过检查 QuerySet.ordered 属性来判断查询是否已排序，如果QuerySet 已以任何方式排序，则该属性将为True。

每个 order_by() 调用将清除任何先前的排序。例如，此查询将按 pub_date 而不是 headline 排序：

Entry.objects.order_by('headline').order_by('pub_date')