En SQLAlchemy, la creación de un modelo implica definir una clase de Python que corresponde a una tabla en la base de datos. Cada instancia de esta clase representa una fila en la tabla. A continuación, se muestra un ejemplo sencillo donde se crea un modelo Comment para almacenar comentarios de usuarios.

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)

Esto define una clase de Python llamada Comment, que representa una tabla en la base de datos. La clase hereda de Base, lo que permite que sea mapeada a una tabla en la base de datos.

__tablename__ = "comments"

La clase Comment, que hereda de Base, define una tabla en la base de datos. Esto permite que sea mapeada a una tabla de base de datos utilizando Mapeo Objeto-Relacional (ORM).

id = Column(Integer, primary_key=True)

El campo id funciona como clave primaria, asegurando que cada comentario tenga un identificador único. SQLAlchemy incrementa automáticamente el valor para cada nuevo registro.

content = Column(Text, nullable=False)

El campo content contiene el texto de un comentario. Es un campo obligatorio, lo que significa que no se puede agregar un comentario a la base de datos si este campo es nulo.

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

El campo created_at almacena automáticamente la marca de tiempo de cuando se creó el comentario. Si no se proporciona un valor, se establece en la hora actual utilizando datetime.utcnow, asegurando que la marca de tiempo se registre en UTC.

Base.metadata.create_all(engine)

Esta línea crea todas las tablas en la base de datos que fueron definidas en los modelos. Utiliza la información de la metadata y crea las tablas necesarias a través de la conexión proporcionada por el engine. Esto es útil para crear automáticamente las tablas si aún no existen.