用于重命名模型和关系字段的Django迁移策略

Question

我计划重命名现有Django项目中的多个模型，在该模型中，还有许多其他模型与我要重命名的模型具有外键关系。我相当确定这将需要多次迁移，但是我不确定确切的过程。

假设我从Django应用程序中的以下模型开始myapp：

class Foo(models.Model):
    name = models.CharField(unique=True, max_length=32)
    description = models.TextField(null=True, blank=True)


class AnotherModel(models.Model):
    foo = models.ForeignKey(Foo)
    is_awesome = models.BooleanField()


class YetAnotherModel(models.Model):
    foo = models.ForeignKey(Foo)
    is_ridonkulous = models.BooleanField()

我想重命名该Foo模型，因为该名称实际上没有任何意义，并且会导致代码混乱，并且Bar会使名称更清晰。

根据我在Django开发文档中阅读的内容，我假设采用以下迁移策略：

第1步

修改models.py：

class Bar(models.Model):  # <-- changed model name
    name = models.CharField(unique=True, max_length=32)
    description = models.TextField(null=True, blank=True)


class AnotherModel(models.Model):
    foo = models.ForeignKey(Bar)  # <-- changed relation, but not field name
    is_awesome = models.BooleanField()


class YetAnotherModel(models.Model):
    foo = models.ForeignKey(Bar)  # <-- changed relation, but not field name
    is_ridonkulous = models.BooleanField()

请注意，的AnotherModel字段名称foo没有更改，但是关系已更新为Bar模型。我的理由是，我不应该一次更改太多，并且如果将该字段名称更改为，则bar可能会丢失该列中的数据。

第2步

创建一个空迁移：

python manage.py makemigrations --empty myapp

第三步

编辑Migration在步骤2中创建的迁移文件中的类，RenameModel以将该操作添加到操作列表中：

class Migration(migrations.Migration):

    dependencies = [
        ('myapp', '0001_initial'),
    ]

    operations = [
        migrations.RenameModel('Foo', 'Bar')
    ]

步骤4

应用迁移：

python manage.py migrate

第5步

在中编辑相关字段名称models.py：

class Bar(models.Model):
    name = models.CharField(unique=True, max_length=32)
    description = models.TextField(null=True, blank=True)


class AnotherModel(models.Model):
    bar = models.ForeignKey(Bar)  # <-- changed field name
    is_awesome = models.BooleanField()


class YetAnotherModel(models.Model):
    bar = models.ForeignKey(Bar)  # <-- changed field name
    is_ridonkulous = models.BooleanField()

第6步

创建另一个空迁移：

python manage.py makemigrations --empty myapp

步骤7

编辑Migration在步骤6中创建的迁移文件中的类，以将RenameField任何相关字段名称的操作添加到操作列表中：

class Migration(migrations.Migration):

    dependencies = [
        ('myapp', '0002_rename_fields'),  # <-- is this okay?
    ]

    operations = [
        migrations.RenameField('AnotherModel', 'foo', 'bar'),
        migrations.RenameField('YetAnotherModel', 'foo', 'bar')
    ]

步骤8
应用第二次迁移：

python manage.py migrate

除了更新其余代码（视图，表单等）以反映新的变量名之外，这基本上是新的迁移功能如何起作用的吗？

另外，这似乎需要很多步骤。迁移操作可以某种方式压缩吗？

谢谢！

Answer 1

因此，当我尝试此操作时，你似乎可以压缩步骤3-7：

class Migration(migrations.Migration):

    dependencies = [
        ('myapp', '0001_initial'), 
    ]

    operations = [
        migrations.RenameModel('Foo', 'Bar'),
        migrations.RenameField('AnotherModel', 'foo', 'bar'),
        migrations.RenameField('YetAnotherModel', 'foo', 'bar')
    ]

如果不更新导入名称，例如admin.py甚至更旧的迁移文件（！），则可能会遇到一些错误。

更新：正如ceasaro所提到的，较新版本的Django通常能够检测并询问是否重命名了模型。因此，请先尝试manage.py makemigrations，然后检查迁移文件。