如何在Django ORM QuerySet更新中为PostgreSQL ArrayField追加值

问题原因 #

你之前的写法报错是因为：

• 直接使用+运算符拼接F("colors")和字符串/列表时，Django无法自动匹配PostgreSQL的数组拼接类型规则，触发类型不匹配错误
• F("colors").append()是Python层面的列表方法调用，不会被翻译成对应的SQL逻辑，且append方法返回None，无法用于更新语句

正确实现方案 #

Django 3.2针对PostgreSQL的ArrayField提供了专门的数组操作表达式，使用ArrayAppend即可实现单次查询批量追加元素：

1. 导入依赖

from django.contrib.postgres.expressions import ArrayAppend
from django.db.models import F

2. 执行批量更新

Dish.objects.filter(category="Cookware").update(
    colors=ArrayAppend(F("colors"), "red")
)

扩展说明 #

如果需要一次追加多个颜色，可以使用ArrayCat表达式传入数组参数：

from django.contrib.postgres.expressions import ArrayCat

Dish.objects.filter(category="Cookware").update(
    colors=ArrayCat(F("colors"), ["red", "blue"])
)

备选方案（手动调用原生函数） #

也可以直接通过Func调用PostgreSQL原生的array_append函数实现相同效果，不需要额外导入Postgres专属表达式：

from django.db.models import F, Func

Dish.objects.filter(category="Cookware").update(
    colors=Func(F("colors"), "red", function="array_append")
)

以上所有写法都只会执行一次数据库更新查询，满足批量更新的需求。

内容的提问来源于stack exchange，提问作者Krishna Manohar