Dans SQLAlchemy, la création d’un modèle consiste à définir une classe Python qui correspond à une table dans la base de données. Chaque instance de cette classe représente une ligne dans la table. Voici un exemple simple où nous créons un modèle Comment pour stocker les commentaires des utilisateurs.

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)

Ceci définit une classe Python appelée Comment, qui représente une table dans la base de données. La classe hérite de Base, ce qui permet de la mapper à une table dans la base de données.

__tablename__ = "comments"

La classe Comment, héritée de Base, définit une table dans la base de données. Cela permet de la mapper à une table de base de données en utilisant l’Object-Relational Mapping (ORM).

id = Column(Integer, primary_key=True)

Le champ id sert de clé primaire, garantissant que chaque commentaire possède un identifiant unique. SQLAlchemy incrémente automatiquement la valeur pour chaque nouvel enregistrement.

content = Column(Text, nullable=False)

Le champ id contient le contenu du commentaire et ne peut pas être nul.

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

Le champ created_at enregistre automatiquement l’horodatage de la création du commentaire. Si aucune valeur n’est fournie, il est défini à l’heure actuelle en utilisant datetime.utcnow, ce qui garantit que l’horodatage est enregistré en UTC.

Base.metadata.create_all(engine)

Cette ligne crée toutes les tables dans la base de données qui ont été définies dans les modèles. Elle utilise les informations provenant des métadonnées et crée les tables nécessaires via la connexion fournie par l’engine. Ceci est utile pour créer automatiquement les tables si elles n’existent pas déjà.