Pada seri belajar Python Part 16, kita telah berhasil melakukan deploy aplikasi Flask sehingga bisa diakses secara online. Namun, data pada aplikasi masih disimpan sementara di dalam list Python. Artinya, ketika server direstart, data tersebut akan hilang.
Agar data dapat disimpan secara permanen, kita membutuhkan database. Pada Part 17 ini, kita akan mempelajari cara menghubungkan Flask dengan database menggunakan Flask-SQLAlchemy.
Yuk, simak langkah-langkahnya dan mulai membuat aplikasi Flask yang dapat menyimpan data dengan lebih aman dan terstruktur.
Apa Itu SQLAlchemy?
SQLAlchemy adalah ORM (Object Relational Mapper) untuk Python, yaitu alat yang memungkinkan kita berinteraksi dengan database menggunakan kode Python biasa (class dan object), tanpa harus menulis query SQL mentah satu per satu. Flask-SQLAlchemy adalah versi yang sudah diintegrasikan khusus untuk framework Flask.
Keuntungan pakai ORM:
- Tidak perlu hafal sintaks SQL yang rumit.
- Kode lebih rapi karena tabel direpresentasikan sebagai class Python.
- Mudah berpindah dari SQLite ke database lain (PostgreSQL, MySQL) tanpa banyak mengubah kode.
Cara Menghubungkan Flask dengan Database
Setelah paham apa itu SQLAlchemy dan manfaat memakai ORM, sekarang saatnya kita praktik langsung. Kita akan menghubungkan Flask dengan database secara bertahap, mulai dari memasang library, mengatur konfigurasi, membuat model, sampai menjalankan operasi CRUD. Langkah pertama yang perlu kita lakukan adalah menginstal Flask-SQLAlchemy.
Step 1: Install Flask-SQLAlchemy
Untuk dapat melakukan instalasi, aktifkan virtual environment proyek, lalu install library-nya:
pip install flask-sqlalchemyJangan lupa update requirements.txt supaya library ini ikut ter-install saat deploy nanti:
pip freeze > requirements.txtStep 2: Konfigurasi Koneksi Flask dengan Database di app.py
Untuk dapat menghubungkan flask dengan database, silakan tambahkan konfigurasi berikut di bagian atas app.py, setelah membuat objek app:
from flask import Flask, render_template, request, redirect, url_for
from flask_sqlalchemy import SQLAlchemy
import os
app = Flask(__name__)
app.config['SQLALCHEMY_DATABASE_URI'] = 'sqlite:///database.db'
app.config['SQLALCHEMY_TRACK_MODIFICATIONS'] = False
db = SQLAlchemy(app)Untuk belajar, kita pakai SQLite dulu karena tidak perlu install server database terpisah. Datanya cukup tersimpan dalam satu file database.db.
Step 3: Membuat Model (Tabel)
Model adalah representasi tabel database dalam bentuk class Python. Misalnya kita ingin membuat aplikasi catatan sederhana, kita bisa buat model Catatan seperti ini:
class Catatan(db.Model):
id = db.Column(db.Integer, primary_key=True)
judul = db.Column(db.String(100), nullable=False)
isi = db.Column(db.Text, nullable=False)
dibuat_pada = db.Column(db.DateTime, server_default=db.func.now())
def __repr__(self):
return f'<Catatan {self.judul}>'Keterangan:
id: primary key, otomatis terisi berurutan.judul: kolom teks pendek, wajib diisi (nullable=False).isi: kolom teks panjang.dibuat_pada: otomatis terisi waktu saat data dibuat.
Step 4: Membuat Tabel di Database
Sebelum tabel bisa dipakai, kita perlu membuatnya terlebih dahulu. Buka Python shell di terminal (pastikan berada di folder proyek dan virtual environment aktif):
pythonLalu jalankan:
from app import app, db
with app.app_context():
db.create_all()Setelah ini, file database.db akan otomatis muncul di folder proyek, lengkap dengan tabel catatan di dalamnya.
Step 5: Operasi CRUD dengan SQLAlchemy
CRUD adalah singkatan dari Create, Read, Update, Delete, yaitu empat operasi dasar yang hampir selalu dipakai saat berurusan dengan database.
Create (Menambah Data)
@app.route('/tambah', methods=['POST'])
def tambah_catatan():
judul = request.form['judul']
isi = request.form['isi']
catatan_baru = Catatan(judul=judul, isi=isi)
db.session.add(catatan_baru)
db.session.commit()
return redirect(url_for('index'))Read (Menampilkan Data)
@app.route('/')
def index():
semua_catatan = Catatan.query.order_by(Catatan.dibuat_pada.desc()).all()
return render_template('index.html', catatan_list=semua_catatan)Lalu di templates/index.html, kita bisa menampilkan datanya dengan Jinja2:
{% for catatan in catatan_list %}
<div class="card mb-3">
<div class="card-body">
<h5 class="card-title">{{ catatan.judul }}</h5>
<p class="card-text">{{ catatan.isi }}</p>
</div>
</div>
{% endfor %}Update (Mengubah Data)
@app.route('/edit/<int:id>', methods=['POST'])
def edit_catatan(id):
catatan = Catatan.query.get_or_404(id)
catatan.judul = request.form['judul']
catatan.isi = request.form['isi']
db.session.commit()
return redirect(url_for('index'))Delete (Menghapus Data)
@app.route('/hapus/<int:id>')
def hapus_catatan(id):
catatan = Catatan.query.get_or_404(id)
db.session.delete(catatan)
db.session.commit()
return redirect(url_for('index'))Step 6: Menyesuaikan Koneksi Flask dengan Database Saat Deploy
Saat aplikasi sudah di-deploy (lihat kembali Part 16: Deploy Aplikasi Flask), ada beberapa penyesuaian yang perlu dilakukan, di antaranya;
Gunakan Environment Variable
Gunakan environment variable supaya URL database tidak ditulis langsung di kode, terutama kalau nanti pindah ke PostgreSQL/MySQL di production:
app.config['SQLALCHEMY_DATABASE_URI'] = os.environ.get(
'DATABASE_URL', 'sqlite:///database.db'
)Pilih Jenis Database yang Sesuai untuk Production
Seperti disinggung di Part 16, SQLite cocok untuk belajar tapi kurang ideal kalau aplikasi sudah menerima banyak pengguna sekaligus, karena SQLite hanya mendukung satu proses penulisan pada satu waktu. Untuk production, lebih disarankan pakai PostgreSQL.
Kalau pakai VPS, bisa install PostgreSQL langsung di server:
apt install postgresql postgresql-contrib -yLalu install driver Python-nya di virtual environment:
pip install psycopg2-binaryDan ubah SQLALCHEMY_DATABASE_URI menjadi format PostgreSQL:
postgresql://username:password@localhost/nama_databaseBuat Ulang Tabel Setelah Pindah Database
Setiap kali pindah ke database baru (misalnya dari SQLite ke PostgreSQL), jangan lupa jalankan lagi db.create_all() di server production agar tabel-tabelnya terbentuk di database yang baru.
Tips Tambahan
- Selalu panggil db.session.commit() setelah add(), delete(), atau perubahan data lain. Tanpa ini, perubahan tidak akan tersimpan ke database.
- Gunakan get_or_404() alih-alih get() biasa saat mengambil data berdasarkan ID, supaya otomatis menampilkan halaman 404 kalau data tidak ditemukan, daripada aplikasi error.
- Untuk proyek yang struktur datanya sering berubah (menambah kolom baru, dsb), pertimbangkan menggunakan library Flask-Migrate di kemudian hari, supaya perubahan struktur tabel bisa dilakukan tanpa kehilangan data.
Source Code
Sebagai rangkuman dari materi belajar Python part 17, berikut adalah keseluruhan kode aplikasi Flask yang sudah kita bangun. Lihat source code.
Penutup
Pada belajar Python part 17 ini, kita telah mempelajari cara menghubungkan Flask dengan database menggunakan Flask-SQLAlchemy, termasuk menyimpan, menampilkan, mengubah, dan menghapus data.
Selanjutnya, pada Belajar Python Part 18, kita akan membahas sistem autentikasi pengguna menggunakan Flask-Login, mulai dari register, login, hingga proteksi halaman.
Demikian belajar Python part 17 dari Rumahweb tentang cara menghubungkan flask dengan database. Tetap ikuti seri belajar Python Rumahweb Journal dan terus praktikkan setiap materi agar skill Python Anda semakin meningkat.



