Aprofundando-se nas migrações do Django

• Parte 1:Migrações do Django:uma introdução
• Parte 2:Aprofundando nas migrações do Django (artigo atual)
• Parte 3:Migrações de dados
• Vídeo:Migrações do Django 1.7 - Uma introdução

• Como o Django acompanha as migrações
• Como as migrações sabem quais operações de banco de dados devem ser executadas
• Como as dependências entre migrações são definidas

Como o Django sabe quais migrações aplicar

$ python manage.py migrate
Operations to perform:
  Apply all migrations: admin, auth, contenttypes, historical_data, sessions
Running migrations:
  No migrations to apply.

O arquivo de migração

from django.db import models, migrations

class Migration(migrations.Migration):
    dependencies = []
    operations = [
        migrations.CreateModel(
            name='PriceHistory',
            fields=[
                ('id', models.AutoField(
                    verbose_name='ID',
                    serialize=False,
                    primary_key=True,
                    auto_created=True)),
                ('date', models.DateTimeField(auto_now_add=True)),
                ('price', models.DecimalField(decimal_places=2, max_digits=5)),
                ('volume', models.PositiveIntegerField()),
                ('total_btc', models.PositiveIntegerField()),
            ],
            options={
            },
            bases=(models.Model,),
        ),
    ]

1. dependencies
2. operations

Operações de migração

1. RunSQL permite executar SQL personalizado no banco de dados.
2. RunPython permite que você execute qualquer código Python.
3. SeparateDatabaseAndState é uma operação especializada para usos avançados.

• BtreeGinExtension
• BtreeGistExtension
• CITextExtension
• CryptoExtension
• HStoreExtension
• TrigramExtension
• UnaccentExtension

Dependências de migração

from django.db import migrations, models

class Migration(migrations.Migration):
    dependencies = [
        ('historical_data', '0001_initial'),
    ]
    operations = [
        migrations.AlterField(
            model_name='pricehistory',
            name='volume',
            field=models.DecimalField(decimal_places=3, max_digits=7),
        ),
    ]

class Migration(migrations.Migration):
    ...

    dependencies = [
        ('auth', '0009_alter_user_last_name_max_length'),
    ]

class Migration(migrations.Migration):
    ...

    run_before = [
        ('third_party_app', '0001_initial'),
    ]

Visualizando a migração

$ python manage.py sqlmigrate historical_data 0001
BEGIN;
--
-- Create model PriceHistory
--
CREATE TABLE "historical_data_pricehistory" (
    "id" integer NOT NULL PRIMARY KEY AUTOINCREMENT,
    "date" datetime NOT NULL,
    "price" decimal NOT NULL,
    "volume" integer unsigned NOT NULL
);
COMMIT;

$ python manage.py sqlmigrate --backwards historical_data 0001
BEGIN;
--
-- Create model PriceHistory
--
DROP TABLE "historical_data_pricehistory";
COMMIT;

Como o Django detecta alterações em seus modelos

Jogando xadrez com Django

• 
  As migrações do Django tentam ser eficientes: Assim como o grande mestre assume que você fez o menor número de movimentos, o Django tentará criar as migrações mais eficientes. Se você adicionar um campo chamado A para um modelo e renomeie-o para B e execute makemigrations , o Django criará uma nova migração para adicionar um campo chamado B .
  
• 
  As migrações do Django têm seus limites: Se você fizer muitos movimentos antes de deixar o grande mestre olhar para o tabuleiro de xadrez, talvez ele não consiga refazer os movimentos exatos de cada peça. Da mesma forma, o Django pode não apresentar a migração correta se você fizer muitas alterações de uma só vez.
  
• 
  A migração do Django espera que você siga as regras: Quando você faz algo inesperado, como tirar uma peça aleatória do quadro ou mexer nas notas, o grande mestre pode não perceber no início, mas mais cedo ou mais tarde, ele vai levantar as mãos e se recusar a continuar. O mesmo acontece quando você mexe com o django_migrations table ou altere seu esquema de banco de dados fora das migrações, por exemplo, excluindo a tabela de banco de dados de um modelo.
  

Compreendendo SeparateDatabaseAndState

1. state_operations contém operações que são aplicadas apenas ao estado do projeto.
2. database_operations contém operações que são aplicadas apenas ao banco de dados.

Conclusão

• O Django acompanha as migrações aplicadas na tabela de migrações do Django.
• As migrações do Django consistem em arquivos Python simples contendo uma Migration aula.
• O Django sabe quais mudanças realizar a partir das operations lista na Migration aulas.
• O Django compara seus modelos com um estado de projeto que ele constrói a partir das migrações.