No SQLAlchemy, criar um modelo envolve definir uma classe Python que corresponde a uma tabela no banco de dados. Cada instância dessa classe representa uma linha na tabela. Vamos analisar um exemplo simples onde criamos um modelo Comment para armazenar comentários de usuários.

from sqlalchemy import Column, Integer, String, Text, DateTime
from sqlalchemy.ext.declarative import declarative_base
from datetime import datetime

Base = declarative_base()

class Comment(Base):
    __tablename__ = "comments"  # the name of the table in the database

    id = Column(Integer, primary_key=True)  # primary key column, uniquely identifies each comment
    content = Column(Text, nullable=False)  # content of the comment, cannot be null
    created_at = Column(DateTime, default=datetime.utcnow)  # timestamp when the comment is created, defaults to current time

# Create all tables defined by models
Base.metadata.create_all(engine)

Isto define uma classe Python chamada Comment, que representa uma tabela no banco de dados. A classe herda de Base, o que permite que ela seja mapeada para uma tabela no banco de dados.

__tablename__ = "comments"

A classe Comment, herdando de Base, define uma tabela no banco de dados. Isso permite que ela seja mapeada para uma tabela do banco de dados utilizando Object-Relational Mapping (ORM).

id = Column(Integer, primary_key=True)

O campo id serve como chave primária, garantindo que cada comentário tenha um identificador único. O SQLAlchemy incrementa automaticamente o valor para cada novo registro.

content = Column(Text, nullable=False)

O campo id armazena o conteúdo do comentário e não pode ser nulo, garantindo que todos os comentários tenham texto associado.

created_at = Column(DateTime, default=datetime.utcnow)

O campo created_at armazena automaticamente o timestamp de quando o comentário foi criado. Se nenhum valor for fornecido, ele é definido para o horário atual usando datetime.utcnow, garantindo que o timestamp seja registrado em UTC.

Base.metadata.create_all(engine)

Esta linha cria todas as tabelas no banco de dados que foram definidas nos modelos. Ela utiliza as informações da metadata e cria as tabelas necessárias através da conexão fornecida pelo engine. Isso é útil para criar automaticamente as tabelas caso ainda não existam.