Crie o esquema com create_all

Os seus modelos descrevem tabelas, mas o arquivo do banco de dados ainda está vazio. É preciso uma etapa para transformar as declarações em tabelas reais. 🏗️

db.create_all() analisa todos os modelos que conhece e emite as instruções CREATE TABLE por si. Uma chamada constrói todo o esquema.

create_all deve ser executado dentro de um contexto da aplicação para encontrar a sua configuração e a conexão correta com o banco de dados.

create_all só cria tabelas para modelos que foram importados. Se um arquivo de modelo nunca for carregado, a tabela correspondente desaparecerá silenciosamente.

Uma forma organizada de configurar o banco de dados é usar o flask shell, no qual o contexto da aplicação já está ativo e pronto.

create_all ignora tabelas que já existem, portanto chamá-lo duas vezes não causará uma falha. Ele simplesmente cria o que estiver faltando.

Aqui está o detalhe: create_all nunca modifica uma tabela existente. Adicione uma nova coluna, e a tabela antiga permanecerá exatamente como estava.

Precisa começar do zero no desenvolvimento? db.drop_all() exclui todas as tabelas e os seus dados, portanto use-o com muito cuidado.

Uma redefinição comum no desenvolvimento é excluir e depois criar. Ela reconstrói tabelas limpas, mas também apaga todos os dados; por isso, nunca faça isso em produção.

Com o SQLite, um arquivo de banco de dados como app.db aparece depois de create_all. Vê-lo confirma que as suas tabelas foram realmente criadas.

Como create_all não pode evoluir um esquema, os projetos reais passam a usar migrações assim que o modelo começa a mudar com o tempo.

Construiu tabelas com db.create_all() dentro de um contexto da aplicação, aprendeu que ele nunca altera tabelas existentes e conheceu drop_all. 🎉