Flask-SQLAlchemy és una extensió per a Flask que simplifica la integració de SQLAlchemy, un ORM (Object-Relational Mapping) per a Python, amb les aplicacions web desenvolupades amb Flask. SQLAlchemy proporciona una interfície d'alt nivell per interactuar amb bases de dades relacionals, permetent als desenvolupadors treballar amb objectes Python en lloc de sentències SQL directes.

• Simplificació de la configuració: Facilita la configuració de SQLAlchemy amb Flask.
• Integració fluida: Proporciona una integració perfecta amb les funcionalitats de Flask.
• Abstracció de la base de dades: Permet treballar amb objectes Python en lloc de sentències SQL.
• Suport per a múltiples bases de dades: Compatible amb diverses bases de dades com SQLite, MySQL, PostgreSQL, etc.

Per començar a utilitzar Flask-SQLAlchemy, primer cal instal·lar l'extensió. Pots fer-ho utilitzant pip:

Després d'instal·lar Flask-SQLAlchemy, cal configurar-lo dins de la teva aplicació Flask. A continuació es mostra un exemple de com fer-ho:

1. Importacions: Importem les classes necessàries de Flask i Flask-SQLAlchemy.
2. Configuració de l'aplicació: Creem una instància de l'aplicació Flask i configurem la URI de la base de dades. En aquest cas, utilitzem una base de dades SQLite anomenada mydatabase.db.
3. Inicialització de SQLAlchemy: Inicialitzem l'extensió SQLAlchemy amb la nostra aplicació Flask.
4. Definició d'un model: Definim un model User amb tres columnes: id, username i email. Aquest model representa una taula a la base de dades.
5. Execució de l'aplicació: Executem l'aplicació Flask en mode de depuració.

Després de definir els models, cal crear la base de dades i les taules corresponents. Això es pot fer utilitzant el mètode create_all() de l'objecte db.

Aquest codi crea totes les taules definides pels models dins del context de l'aplicació.

Crear una aplicació Flask que utilitzi Flask-SQLAlchemy per gestionar una base de dades d'usuaris.

1. Instal·la Flask i Flask-SQLAlchemy:

   pip install flask flask-sqlalchemy
   

2. Crea un fitxer app.py i afegeix el següent codi:

   from flask import Flask
   from flask_sqlalchemy import SQLAlchemy
   
   app = Flask(__name__)
   
   app.config['SQLALCHEMY_DATABASE_URI'] = 'sqlite:///users.db'
   app.config['SQLALCHEMY_TRACK_MODIFICATIONS'] = False
   
   db = SQLAlchemy(app)
   
   class User(db.Model):
       id = db.Column(db.Integer, primary_key=True)
       username = db.Column(db.String(80), unique=True, nullable=False)
       email = db.Column(db.String(120), unique=True, nullable=False)
   
       def __repr__(self):
           return f'<User {self.username}>'
   
   @app.route('/')
   def index():
       return "Hello, Flask-SQLAlchemy!"
   
   if __name__ == '__main__':
       with app.app_context():
           db.create_all()
       app.run(debug=True)
   

3. Executa l'aplicació:

   python app.py
   

4. Verifica que la base de dades users.db s'ha creat al directori del teu projecte.

El codi anterior crea una aplicació Flask que utilitza Flask-SQLAlchemy per gestionar una base de dades SQLite anomenada users.db. La base de dades conté una taula User amb les columnes id, username i email.

En aquesta secció, hem après què és Flask-SQLAlchemy, com instal·lar-lo i configurar-lo, i com definir models per interactuar amb una base de dades. També hem creat una aplicació Flask senzilla que utilitza Flask-SQLAlchemy per gestionar una base de dades d'usuaris. En el proper mòdul, explorarem com definir models més complexos i realitzar operacions CRUD (Crear, Llegir, Actualitzar, Esborrar) amb Flask-SQLAlchemy.