Django从CharField迁移至LocalizedCharField的数据迁移方案咨询

方案步骤 #

1. 临时调整模型定义 #

先保留原CharField类型的title，新增LocalizedCharField类型的临时字段title_localized，同时让模型继承LocalizedModel：

from django.db import models
from localized_fields.models import LocalizedModel, LocalizedCharField

class FineModel(LocalizedModel):
    # 保留原字段用于数据迁移
    title = models.CharField(max_length=255)
    # 新增临时Localized字段
    title_localized = LocalizedCharField(max_length=255)
    # 其他原有字段保持不变

2. 生成初始迁移文件 #

执行命令生成迁移：

python manage.py makemigrations your_app_name

替换your_app_name为你的实际应用名称。

3. 编辑迁移文件，整合数据迁移逻辑 #

打开生成的迁移文件，修改operations列表，按顺序添加数据复制、删除旧字段、重命名新字段的操作：

from django.db import migrations, models
import localized_fields.models

def copy_title_to_localized(apps, schema_editor):
    FineModel = apps.get_model('your_app_name', 'FineModel')
    # 优先用批量更新（高效，适合大数据量）
    try:
        FineModel.objects.update(**{'title_localized__en': models.F('title')})
    except Exception:
        # 若批量更新不支持，改用逐个实例处理
        for obj in FineModel.objects.all():
            obj.title_localized.en = obj.title
            obj.save(update_fields=['title_localized'])

class Migration(migrations.Migration):
    dependencies = [
        ('your_app_name', '替换为你的上一个迁移文件名'),
    ]

    operations = [
        # 1. 添加临时Localized字段
        migrations.AddField(
            model_name='finemodel',
            name='title_localized',
            field=localized_fields.models.LocalizedCharField(max_length=255),
        ),
        # 2. 将原title数据复制到临时字段的英文版本（默认语言）
        migrations.RunPython(copy_title_to_localized),
        # 3. 删除原CharField字段
        migrations.RemoveField(
            model_name='finemodel',
            name='title',
        ),
        # 4. 将临时字段重命名为title
        migrations.RenameField(
            model_name='finemodel',
            old_name='title_localized',
            new_name='title',
        ),
    ]

4. 执行迁移 #

运行迁移命令完成所有操作：

python manage.py migrate your_app_name

5. 最终调整模型 #

迁移完成后，删除模型里的临时字段定义，保留最终的LocalizedCharField：

from django.db import models
from localized_fields.models import LocalizedModel, LocalizedCharField

class FineModel(LocalizedModel):
    title = LocalizedCharField(max_length=255)
    # 其他原有字段保持不变

注意事项 #

• 批量更新使用models.F可以避免将所有实例加载到内存，大幅提升大数据量场景下的迁移效率；如果遇到LocalizedField不支持F表达式的情况，再切换到循环逐个保存的方式。
• 迁移前务必备份生产数据库，并在测试环境验证迁移流程的正确性。
• 迁移文件中的dependencies必须替换为你的应用实际的上一个迁移文件名，否则会导致迁移顺序错误。

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