Defina sua primeira classe de modelo
Mapeie uma classe Python para uma tabela do banco de dados.
Defina sua primeira classe de modelo é uma aula grátis de Flask Academy no CoddyKit. Esta é a aula 2 de 4. Você pode ler a aula completa abaixo gratuitamente — depois pratica ao vivo no navegador com um editor de código integrado e um tutor de IA 24/7. Faz parte do caminho de aprendizado de Flask Academy, e seu progresso é sincronizado entre a web e o app CoddyKit. O curso de Flask Academy inclui 4 aulas no total.
Um modelo é uma tabela
No mundo dos ORM, uma classe Python equivale a uma tabela do banco de dados. Cada modelo descreve a estrutura das linhas que armazenará. 🧱
Herede de db.Model
A sua classe é uma subclasse de db.Model. Essa única classe base fornece gratuitamente recursos de tabela, como consulta e gravação.
class User(db.Model):
passDo nome da classe ao nome da tabela
Por padrão, o nome da tabela é o nome da classe em minúsculas. Assim, uma classe chamada User é associada automaticamente a uma tabela chamada user.
As colunas são atributos da classe
Cada campo é um atributo da classe definido como db.Column. O tipo da coluna, como Integer ou String, informa ao banco de dados o que deve ser armazenado.
name = db.Column(db.String(80))Toda tabela precisa de uma chave
Uma coluna deve ser a chave primária: um identificador exclusivo para cada linha. É assim que o banco de dados diferencia os seus registros.
id = db.Column(db.Integer, primary_key=True)O seu primeiro modelo completo
Junte tudo: uma chave e alguns campos. Essa pequena classe descreve completamente uma tabela User e as suas colunas.
class User(db.Model):
id = db.Column(db.Integer, primary_key=True)
name = db.Column(db.String(80))Substitua o nome da tabela
Quer um nome de tabela personalizado? Defina __tablename__ na classe, e o ORM usará esse nome em vez do padrão.
__tablename__ = "users"Crie instâncias como objetos
Uma instância de modelo é apenas um objeto Python comum. Passe os valores das colunas como argumentos nomeados, e cada um se tornará uma linha a ser salva.
u = User(name="Ada")Adicione uma repr útil
Definir __repr__ faz com que os objetos sejam exibidos claramente no shell e nos registros, evitando suposições durante a depuração.
def __repr__(self):
return f"<User {self.name}>"Mantenha os modelos em um só lugar
Mantenha os modelos em um arquivo models.py para que sejam importados corretamente por visões, scripts e testes, sem importações circulares.
Nenhum SQL à vista
Observe que nunca escreveu CREATE TABLE. A declaração do modelo é o esquema, e o ORM a traduz para SQL por si.
Verificação rápida
O que uma classe de modelo do Flask-SQLAlchemy representa?
Recapitulação
Construiu um modelo criando uma subclasse de db.Model, declarou colunas, definiu uma chave primária e aprendeu que a própria classe é o seu esquema. ✅
Aprenda Python com um tutor de IA — grátis
Escreva e execute código real no seu navegador, obtenha ajuda instantânea de um tutor de IA 24/7 e continue de onde parou na web ou no app.
- Cursos
- 30
- Aulas
- 120
Perguntas Frequentes
A aula “Defina sua primeira classe de modelo” é grátis?
Sim — o texto completo de “Defina sua primeira classe de modelo” é grátis para ler aqui na web. Para praticá-la interativamente (um editor de código integrado e um tutor de IA 24/7) e desbloquear o restante do curso de Flask Academy, atualize para CoddyKit PRO. O curso de Flask Academy inclui 4 aulas no total.
O que vou aprender em “Defina sua primeira classe de modelo”?
Mapeie uma classe Python para uma tabela do banco de dados. Você pratica Flask Academy com código prático que executa diretamente no navegador, e um tutor de IA 24/7 responde suas dúvidas enquanto trabalha na aula.
Preciso ter experiência prévia para começar Flask Academy?
Nenhuma experiência prévia é necessária. Flask Academy no CoddyKit é estruturado para alunos iniciantes até avançados, então você pode começar aqui ou desde o início e aprender no seu ritmo. Esta é a aula 2 de 4.
Quanto tempo leva a aula “Defina sua primeira classe de modelo”?
A maioria das aulas CoddyKit leva cerca de 5–10 minutos. Cada uma é compacta e interativa, então você faz progresso constante e retoma exatamente de onde parou entre web e app.
Posso escrever e executar código nesta aula de Flask Academy?
Sim. Cada aula de Flask Academy inclui um editor de código integrado, então você escreve e executa código real direto no navegador e recebe feedback de IA instantaneamente — nenhuma configuração local necessária.
Todas as aulas deste curso
- Instale e configure a extensão
- Defina sua primeira classe de modelo
- Colunas, tipos e restrições
- Crie o esquema com create_all