SQLAlchemy est un ORM (Object-Relational Mapping) il permet de traduire les objets Python en données pouvant être enregistrées dans un SGBD externe.

Pour pouvoir utiliser l'extension, installer le module Flask-SQLAlchemy

# Dans votre environnement virtuel
pip install Flask-SQLAlchemy

Lors de la phase de développement ou pendant les tests, il peut être utile d'utiliser une base de donnée SQLite en RAM seulement (pour éviter les écritures sur disque).

Pour cela on définit la valeur de la variable de configuration SQLALCHEMY_DATABASE_URI comme indiqué ci-dessous :

# Pour utiliser une base SQLite en mémoire l'URL doit être vide
app.config["SQLALCHEMY_DATABASE_URI"] = 'sqlite://'

Il peut être également utile d' afficher les requêtes produites par l'ORM.

• db.Boolean
• db.Integer
• db.Float(precision=2)
• db.String(100)
• db.Text
• db.Date
• db.DateTime

source : Les types de données (docs.sqlalchemy.org)

Ici on récupères tous les enregistrements en spécifiant l'ordre

>>> # Récupère l'enregistrement dont le nom est 'memo'
>>> mc = MarkerCategory.query.where(MarkerCategory.name == 'memo').all()
>>> mc
[<MarkerCategory id=2 name="memo" builtin=True icon=/static/img/notepad_9021656_icon.png marker_icon=None >]

Les différentes associations entre tables sont abordées dans les notes suivantes :

• Définir des associations one-to-many
• Définir des associations many-to-many

from sqlalchemy.exc import IntegrityError, OperationalError
...
 
try:
    # Code SQLAlchemy susceptible de lever une exception
    db.session.commit()
 
except (IntegrityError, OperationalError) as e:
    # Traitement des exceptions
    db.session.rollback()
    print(f"An error occurred: {str(e)}")

• https://flask-sqlalchemy.palletsprojects.com/en/stable/
• https://docs.sqlalchemy.org/en/20/orm/basic_relationships.html#one-to-one
• https://pythonbasics.org/flask-sqlalchemy/
• https://www.slingacademy.com/article/solving-sqlalchemy-integrityerror-when-inserting-data/
• https://www.codementor.io/@garethdwyer/building-a-crud-application-with-flask-and-sqlalchemy-dm3wv7yu2
• https://www.digitalocean.com/community/tutorials/how-to-use-one-to-many-database-relationships-with-flask-sqlalchemy
• https://stackoverflow.com/questions/18807322/sqlalchemy-foreign-key-relationship-attributes
• https://www.youtube.com/watch?v=g0-7TrVCNtg
• Maitriser les opérations sur les bases de données avec Flask-SQLAlchemy (codezup.com)
• Traitement des exceptions SQLAlchemy (dnmtechs.com)