Python Django QuerySet.in_bulk用法及代碼示例

本文介紹 django.db.models.query.QuerySet.in_bulk 的用法。

聲明

in_bulk(id_list=None, *, field_name='pk')

獲取字段值列表 (id_list) 和這些值的 field_name，並返回一個字典，將每個值映射到具有給定字段值的對象實例。 in_bulk 不會引發任何 django.core.exceptions.ObjectDoesNotExist 異常；也就是說，任何不匹配任何實例的 id_list 值都將被忽略。如果未提供 id_list，則返回查詢集中的所有對象。 field_name 必須是唯一字段或不同字段(如果在 distinct() 中僅指定一個字段)。 field_name 默認為主鍵。

例子：

>>> Blog.objects.in_bulk([1])
{1: <Blog: Beatles Blog>}
>>> Blog.objects.in_bulk([1, 2])
{1: <Blog: Beatles Blog>, 2: <Blog: Cheddar Talk>}
>>> Blog.objects.in_bulk([])
{}
>>> Blog.objects.in_bulk()
{1: <Blog: Beatles Blog>, 2: <Blog: Cheddar Talk>, 3: <Blog: Django Weblog>}
>>> Blog.objects.in_bulk(['beatles_blog'], field_name='slug')
{'beatles_blog': <Blog: Beatles Blog>}
>>> Blog.objects.distinct('name').in_bulk(field_name='name')
{'Beatles Blog': <Blog: Beatles Blog>, 'Cheddar Talk': <Blog: Cheddar Talk>, 'Django Weblog': <Blog: Django Weblog>}

如果你傳遞 in_bulk() 一個空列表，你會得到一個空字典。

在 Django 3.2 中更改：

允許使用不同的字段。

相關用法

注：本文由純淨天空篩選整理自djangoproject.com大神的英文原創作品 django.db.models.query.QuerySet.in_bulk。非經特殊聲明，原始代碼版權歸原作者所有，本譯文未經允許或授權，請勿轉載或複製。