Django项目中如何在PostgreSQL不同schema下创建指定数据表？

1. 提前创建数据库Schema并赋权 #

Django不会自动创建PostgreSQL的独立Schema，先连接到目标PostgreSQL数据库执行以下SQL：

-- 创建专属myapp的schema
CREATE SCHEMA IF NOT EXISTS myapp;
-- 给Django使用的数据库账号分配schema权限，把`your_db_user`替换成项目配置里的真实数据库用户名
GRANT USAGE, CREATE ON SCHEMA myapp TO your_db_user;
GRANT ALL ON ALL TABLES IN SCHEMA myapp TO your_db_user;
ALTER DEFAULT PRIVILEGES IN SCHEMA myapp GRANT ALL ON TABLES TO your_db_user;

2. 修改项目数据库配置 #

在settings.py的数据库连接配置中，添加search_path参数，让Django连接时能识别两个schema下的对象：

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.postgresql',
        'NAME': '你的数据库名',
        'USER': 'your_db_user',
        'PASSWORD': '你的数据库密码',
        'HOST': '127.0.0.1',
        'PORT': '5432',
        'OPTIONS': {
            # 按优先级设置搜索路径，public放前面保证系统表默认落到public
            'options': '-c search_path=public,myapp'
        }
    }
}

3. 给模型指定归属Schema #

Django的PostgreSQL后端原生支持在db_table参数中通过schema名.表名的格式指定表所属schema，直接修改对应模型的Meta配置即可：

• users应用下的UserProfile模型（显式指定到public，不写前缀默认也会落到public，显式配置可避免后续配置变动出错）

class UserProfile(models.Model):
    # 你的业务字段定义
    class Meta:
        db_table = 'public.user_profile'

• myapp应用下的CustomModel模型（指定到myapp schema）

class CustomModel(models.Model):
    # 你的业务字段定义
    class Meta:
        db_table = 'myapp.custom_model'

如果myapp下后续有多个模型都要放到myapp schema，直接给每个模型的db_table加上myapp.前缀即可，不需要额外引入第三方包。

数据查询 #

完全不需要做特殊调整。
只要通过ORM操作数据，不管是普通的过滤、聚合、连表查询，还是跨schema的外键关联，Django都会自动在生成的SQL中带上正确的schema前缀，和之前单schema的写法完全一致，比如：

# 正常调用即可，不需要手动加schema
UserProfile.objects.filter(is_active=True)
CustomModel.objects.select_related('user').all()

只有在写原生SQL语句时，才需要注意如果表不在search_path的优先路径下，最好手动带上schema前缀避免表不存在的报错。

数据库迁移 #

常规迁移命令不需要调整，只需要注意两个特殊点：

• 正常执行python manage.py makemigrations、python manage.py migrate即可，Django会自动根据模型配置的db_table，把表建到对应的schema下，Django自身的系统表（auth、admin、migrations记录等）会默认落到public schema，符合预期。
• 如果之前已经在public schema下生成过CustomModel的迁移文件，需要先清理旧的迁移记录，或者手动修改迁移文件中CreateTable操作对应的表名，否则会出现表位置错误、迁移冲突的问题。

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