Bladeren bron

Fixed #30597 -- Clarified how to unapply migrations.

David Vaz 5 jaren geleden
bovenliggende
commit
45554fd5c5
2 gewijzigde bestanden met toevoegingen van 26 en 2 verwijderingen
  1. 2 2
      docs/ref/django-admin.txt
  2. 24 0
      docs/topics/migrations.txt

+ 2 - 2
docs/ref/django-admin.txt

@@ -802,8 +802,8 @@ The behavior of this command changes depending on the arguments provided:
 * ``<app_label> <migrationname>``: Brings the database schema to a state where
   the named migration is applied, but no later migrations in the same app are
   applied. This may involve unapplying migrations if you have previously
-  migrated past the named migration. Use the name ``zero`` to unapply all
-  migrations for an app.
+  migrated past the named migration. Use the name ``zero`` to migrate all the
+  way back i.e. to revert all applied migrations for an app.
 
 .. warning::
 

+ 24 - 0
docs/topics/migrations.txt

@@ -347,6 +347,30 @@ Note that this only works given two things:
   that your database doesn't match your models, you'll just get errors when
   migrations try to modify those tables.
 
+Reverting migrations
+====================
+
+Any migration can be reverted with :djadmin:`migrate` by using the number of
+previous migrations::
+
+    $ python manage.py migrate books 0002
+    Operations to perform:
+      Target specific migration: 0002_auto, from books
+    Running migrations:
+      Rendering model states... DONE
+      Unapplying books.0003_auto... OK
+
+If you want to revert all migrations applied for an app, use the name
+``zero``::
+
+    $ python manage.py migrate books zero
+    Operations to perform:
+      Unapply all migrations: books
+    Running migrations:
+      Rendering model states... DONE
+      Unapplying books.0002_auto... OK
+      Unapplying books.0001_initial... OK
+
 .. _historical-models:
 
 Historical models