Django对接SQL Server时类似PostgreSQL ArrayField的替代方案咨询

SQL Server本身没有内置的数组字段类型，没有完全和PostgreSQL ArrayField行为完全一致的原生实现，以下是三种常用的等效替代方案，适配不同的业务场景：

方案1：JSON字段封装自定义ArrayField（优先推荐） #

SQL Server 2016及以上版本原生支持JSON类型，Django的SQL Server后端也已兼容JSONField，你可以基于JSONField封装自定义字段，实现和ArrayField几乎一致的使用体验：

from django.db import models
import json

class SQLServerArrayField(models.JSONField):
    def __init__(self, base_field, **kwargs):
        self.base_field = base_field
        super().__init__(**kwargs)

    def to_python(self, value):
        if value is None:
            return value
        if isinstance(value, str):
            value = json.loads(value)
        # 对数组每个元素做类型转换
        return [self.base_field.to_python(item) for item in value]

    def get_prep_value(self, value):
        if value is None:
            return value
        # 校验每个元素的格式
        prep_value = [self.base_field.get_prep_value(item) for item in value]
        return super().get_prep_value(prep_value)

使用方式和原生ArrayField基本一致，例如要存储字符串标签数组：

class Post(models.Model):
    # 等效于PostgreSQL的 ArrayField(models.CharField(max_length=50), default=list)
    tags = SQLServerArrayField(base_field=models.CharField(max_length=50), default=list)

• 优点：代码改动量极小，支持使用SQL Server的JSON函数查询数组内元素，兼容Django ORM的大部分查询语法
• 缺点：仅支持SQL Server 2016及以上版本，数组元素查询性能略低于原生ArrayField

方案2：一对多关联表（适合高频查询场景） #

如果你的数组元素需要频繁过滤、聚合、做唯一约束，可以按照关系型数据库的标准设计，将数组拆分为独立的关联表：

# 原有PostgreSQL写法
# class Post(models.Model):
#     tags = ArrayField(models.CharField(max_length=50), default=list)

# 改造后SQL Server兼容写法
class Post(models.Model):
    title = models.CharField(max_length=200)

class PostTag(models.Model):
    post = models.ForeignKey(Post, on_delete=models.CASCADE, related_name="tags")
    tag = models.CharField(max_length=50)

    class Meta:
        # 避免同一个文章重复添加相同标签
        unique_together = ("post", "tag")

查询包含指定标签的文章可以直接用ORM语法：Post.objects.filter(tags__tag="django")

• 优点：符合关系型数据库设计规范，查询性能高，支持索引、唯一约束等特性
• 缺点：原有直接操作数组的业务代码需要调整为操作关联模型，改动量较大

方案3：分隔符拼接存储（适合简单轻量场景） #

如果使用的SQL Server版本低于2016，且数组仅做存储不需要频繁查询内部元素，可以将数组用固定分隔符拼接为字符串存储：

from django.db import models

class SeparatedArrayField(models.CharField):
    def __init__(self, sep=",", *args, **kwargs):
        self.sep = sep
        super().__init__(*args, **kwargs)

    def to_python(self, value):
        if not value:
            return []
        if isinstance(value, list):
            return value
        return value.split(self.sep)

    def get_prep_value(self, value):
        if not value:
            return ""
        return self.sep.join(str(item) for item in value)

• 优点：兼容所有SQL Server版本，实现成本极低
• 缺点：不支持高效查询数组内元素，不能存储包含分隔符的内容，仅适合非核心的轻量场景

内容的提问来源于stack exchange，提问作者Rihab sabri