如何将Django连接到含已存在单表的遗留PostgreSQL数据库？

• 先打开pgAdmin4，右键点击你要对接的目标数据库，选择「备份」，格式选择custom，存储到本地安全路径，所有后续操作如果出错都可以通过这个备份恢复数据。
• 建议先创建一个测试数据库，将备份恢复到测试库中，所有操作先在测试库验证通过后，再操作正式的生产库。

1. 初始化Django系统表 #

你修改settings指向目标PostgreSQL库后，首先需要生成Django运行必须的内置系统表（权限、会话、日志表等）：

• 执行命令 python manage.py migrate
• 只要你的遗留表表名和Django内置表（以auth_、django_、session_开头的表）没有重名，这一步只会创建Django需要的系统表，完全不会修改、删除你已有的遗留表和数据
• 如果gitbash中提示找不到python命令，可以换成py或python3执行

2. 自动生成遗留表对应的Django模型 #

不需要手动写模型，直接用Django内置的inspectdb命令自动从现有表结构生成模型代码：

• 执行命令 python manage.py inspectdb > legacy_models.py
• 这一步是完全只读的操作，只会读取数据库的表结构生成Python代码，不会对数据库做任何修改，新手可以放心执行
• 执行完成后你会在项目根目录得到一个legacy_models.py文件，里面就是遗留表对应的Django模型代码

3. 调整模型配置 #

把生成的模型代码复制到你对应app的models.py文件中，需要确认以下配置：

• 每个遗留表的模型类的Meta选项下都会默认生成managed = False，这个配置必须保留，含义是Django不会对该表执行任何创建、修改、删除的迁移操作，从根源上避免Django修改你的遗留表数据
• 检查字段类型是否符合你的预期，比如PostgreSQL的jsonb、timestamp with time zone等特殊字段如果识别不准确，可以手动调整成对应的Django字段类型
• 如果需要给模型改个更易读的名字，只需要修改类名，保留db_table = '你的原有遗留表名'配置即可

4. 验证安全配置 #

调整完模型后执行以下命令验证是否安全：

• 执行 python manage.py makemigrations
• 检查生成的迁移文件，确认没有任何针对你遗留表的操作（因为managed=False的表不会被Django纳入迁移管理）
• 确认无误后执行 python manage.py migrate 即可完成所有对接操作

• 除非你确定要将遗留表的结构管理完全交给Django，否则不要删除managed = False配置
• 后续如果需要修改遗留表的结构，建议手动写SQL在pgAdmin中执行，不要用Django的迁移操作修改遗留表
• 日常查询、写入遗留表的数据可以正常用Django ORM操作，和普通自建模型的用法完全一致，不会影响原有数据的结构

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