Problemas com migrações

Neste artigo vamos falar sobre migrações no Web2py.

Todos sabemos que o W2P faz proezas com a DAL mas as vezes temos alguns percalços no caminho.

Para fazer o controle do estado das migrações é criado por padrão na pasta databases alguns arquivos com a extensão '.table'.

Esses arquivos são responsáveis por armazenar o estado atual da tabela e logo eles são modificados quando fazemos alterações na definição de tabela no código python.

De fato esses arquivos são muito úteis porém há momentos em que eles começam a dar problemas.

Primeiro de tudo vamos começar mudando nosso código na função define_table passando um argumento migrate='nome_tabela.table'.

db.define_table('tabela1',
    Field('nome_campo', 'string'),
    migrate='tabela1.table'
)

Isso fará com que o arquivo .table da tabela1 contenha seu nome, isso facilita evita aqueles arquivos redundantes no diretório.

O próximo passo é entender como funcionam as migrações do construtor DAL.

Isso foi retirado da docstring da pydal do Web2py (gluon.packages.base.py).

migrate: sets default migrate behavior for all tables
fake_migrate: sets default fake_migrate behavior for all tables
migrate_enabled: If set to False disables ALL migrations
fake_migrate_all: If set to True fake migrates ALL tables

migrate: Determina a migração padrão para todas as tabelas se True, no nosso caso estamos usando um migrate customizado em nosso define_table, então pode alterá-lo para False.

fake_migrate: Ele utiliza o padrão False, ele será usado para tratar migrações individuais em bancos de dados legados.

migrate_enabled: Habilita as migrações, seu padrão é True.

fake_migrate_all: É utilizado em bancos legados e atribui um tratamento padrão para todas as tabelas.

db = DAL(myconf.get("db.uri"),
        pool_size=10,
        migrate_enabled=myconf.get('db.migrate_enabled'), # True
        fake_migrate=myconf.get('db.fake_migrate'), # False
        fake_migrate_all=myconf.get('db.fake_migrate_all'), # False
        migrate=myconf.get('db.migrate'), # False
        check_reserved=['all'])

O exemplo acima seria a configuração padrão para criar um banco de dados do zero. Ou seja ele iria criar as tabelas para nós utilizando um .table customizado.

Caso ele retorne algum erro de cara, execute a aplicação quantas vezes precisar até que ele crie todas as tabelas e arquivos.

NOTA: Muito cuidado com campos notnull=True geralmente eles não são criados por exigirem sempre um valor padrão, então o notnull=True deve vir acompanhado de um default='anyway'.

<class 'gluon.contrib.pg8000.ProgrammingError'> ('ERRO', '23502', 'valor nulo na coluna "colunaXYZ" viola a restrição não-nula')


Em bases Legadas ou estruturas já criadas

Haverão casos onde precisamos lidar com estruturas legadas ou já criadas, nesse caso podem haver problemas como:

<class 'gluon.contrib.pg8000.ProgrammingError'> ('ERRO', '42701', 'coluna "colunaXYZ" da relação "tableZYX" já existe')


A solução padrão para este caso é apagar todos os arquivos '.table' e o arquivo sql.log.
Feito isso devemos setar como True o parâmetro fake_migrate_all e executarmos nosso app até atualizar o banco.
db = DAL(myconf.get("db.uri"),
        pool_size=10,
        migrate_enabled=myconf.get('db.migrate_enabled'), # True
        fake_migrate=myconf.get('db.fake_migrate'), # False
        fake_migrate_all=myconf.get('db.fake_migrate_all'), # True
        migrate=myconf.get('db.migrate'), # False
        check_reserved=['all'])

Depois retorne o parâmetro fake_migrate_all para False.


Espero ter sanado as duvidas dos novatos por que ninguém merece perder todo um dia de trabalho fazendo migrações manuais na base de dados.💀


Comentários

Postar um comentário

Postagens mais visitadas deste blog

Web2py com NGINX

 Neste artigo falaremos sobre como usar o web2py com NGINX. 1º Passo Em nosso servidor temos o Ubuntu 20.04 Server, vamos nos basear fortemente no script de instalação do web2py setup-web2py-nginx-uwsgi-ubuntu.sh encontrado em scripts na pasta do web2py. Diferente do Apache o NGINX utiliza o padrão UWSGI enquanto no apache usamos o mod_python, não vamos entrar em detalhes, você pode pesquisar sobre a diferença entre os dois depois. Você pode começar rodando o script no seu servidor caso esteja usando uma instalação do zero, depois iremos modificar os arquivos de configuração a nossa maneira. Agora que tudo está instalado é preciso configurar o virtualenv para o projeto. :~$ virtualenv -p /usr/bin/python3 /opt/venv3 2º Passo Diferente do apache o NGIX precisa de um "intermediário" que chama o arquivo wsgihandler de cada ambiente. Então vamos começar modificando as instalações que foram feitas no script. E vamos começar pelo processo uwsgi criado nesse script, modifique-o para ...
Leia mais

Configurar o web2py no Apache e Ubuntu LTS

Para todo desenvolvedor o maior desafio não é produzir código e sim colocar sua aplicação para rodar de fato de verdade, por isso é essencial conhecer todos os passos para fazer o deploy de sua aplicação em ambientes de produção. Este artigo será composto por este principal e outros dois explicando a teoria envolvendo o processo. Neste artigo explicaremos em forma de tutorial como fazer o deploy de uma aplicação web2py tem um servidor Apache usando virtual hosts. Antes de prosseguirmos é importante fazer algumas considerações. 1- O web2py é um framework baseado no padrão WSGI (Web Server Gateway interactive), um avanço no antigo CGI, portanto vamos precisar de um arquivo intermediário entre o módulo wsgi do apache e o framework, chamado de handler. 2- O Apache ainda é o servidor WEB mais utilizado no mercado por tanto há vasta documentação espalhada por aí, logo não será muito difícil dar manutenção nele. 3- O Ubuntu também é a distro linux mais usada no mundo desktop portanto não tere...
Leia mais

API RESTFul no web2py

 Este artigo é uma cópia do original em http://www.web2pyslices.com/slice/show/1533/restful-api-with-web2py acessado em 06/04/2021 18:55 autor Bruno Rocha Hi,   1. Create an app in web2py admin panel   2. In models/db.py define a table named entries   Entries = db . define_table ( "entries" , Field ( "entry" , "text" )) 3. Register a new user in http://localhost:8000/myapp/default/user/register   4. Go to appadmin http://localhost:8000/myapp/appadmin and Add a couple of entries.   5. now add the RESTful services to the default.py controller as described in  http://goo.gl/iITNd  ('parse_as_rest') or here:  http://goo.gl/ltfa2   @request . restful () def api (): response . view = 'generic.' + request . extension def GET (* args ,** vars ): patterns = 'auto' parser = db . parse_as_rest ( patterns , args , vars ) if parser . status == 200 : return dict ( content = parser . respons...
Leia mais