如何向客户交付含PostgreSQL的Django项目并保留数据库数据？

针对你需要将PostgreSQL数据库完整交付给客户的需求，这里提供几个比Django dumpdata/loaddata更实用的方案，按推荐优先级排序：

方案1：PostgreSQL原生pg_dump+pg_restore（首推） #

这是PostgreSQL官方提供的备份恢复工具，完全适配PostgreSQL的所有特性，效率远高于Django的命令，适合全量数据库交付场景。

备份步骤（你的机器上执行） #

pg_dump -U 你的数据库用户名 -d 目标数据库名 -F c -b -v -f db_backup.dump

参数说明：

• -F c：生成压缩的自定义格式备份，支持并行恢复，文件更小
• -b：包含大对象（如bytea类型数据）
• -v：显示备份进度详情

恢复步骤（客户机器上执行） #

1. 先让客户安装与你版本一致的PostgreSQL，创建空的目标数据库
2. 执行恢复命令：

pg_restore -U 客户数据库用户名 -d 客户目标数据库名 -v db_backup.dump

优势：

• 速度快，大数据量场景下碾压Django命令
• 完整保留所有数据库对象：表结构、索引、约束、触发器、自定义函数、视图等
• 支持增量备份、并行恢复等高级功能

方案2：优化版Django dumpdata/loaddata #

如果客户环境完全依赖Django，也可以优化这个流程来提升效率：

备份时优化 #

排除Django自带的无关表（如会话、权限、内容类型），改用更高效的格式：

python manage.py dumpdata --exclude auth.permission --exclude contenttypes --exclude django_session --format yaml -f data_dump.yaml

恢复步骤 #

客户先执行迁移创建表结构，再加载数据：

python manage.py migrate
python manage.py loaddata data_dump.yaml

注意：外键关联会被自动处理，但数据量较大时速度明显不如pg_dump，且无法保留PostgreSQL特有的数据库对象。

方案3：定制化CSV批量导入脚本 #

如果客户只需要初始的CSV数据，且可以自行通过Django迁移创建表结构，可编写自定义管理命令实现高效导入：

编写导入脚本 #

在项目的management/commands目录下创建import_csv.py：

from django.core.management.base import BaseCommand
from yourapp.models import YourModel
import csv

class Command(BaseCommand):
    help = '批量导入CSV数据到数据库'

    def add_arguments(self, parser):
        parser.add_argument('csv_path', type=str, help='CSV文件路径')

    def handle(self, *args, **options):
        with open(options['csv_path'], 'r', encoding='utf-8') as f:
            reader = csv.DictReader(f)
            # 用bulk_create批量插入，比逐条save快数倍
            obj_list = [YourModel(**row) for row in reader]
            YourModel.objects.bulk_create(obj_list, batch_size=1000)
        self.stdout.write(self.style.SUCCESS('数据导入完成'))

客户执行导入 #

python manage.py import_csv your_data.csv

优势：灵活适配CSV格式，适合仅需交付初始业务数据的场景

方案对比 #

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