ORM vs Raw SQL 🪑

Perdebatan abadi, di mana satu pihak mendukung "kenyamanan", dan pihak lain mendukung "kontrol".

🪑 Kursi #1: SQLAlchemy ORM

ORM bukan tentang kecepatan kode, ini tentang kecepatan pengiriman fitur. Anda bekerja dengan objek, bukan string.

✅ Mengapa ini keren:
— Unit of Work: Alchemy sendiri melacak perubahan objek dan mendorongnya ke database dalam satu paket transaksional.
— Keamanan: SQL injection? Lupakan. Jika Anda tidak menggunakan .text(), Anda terlindungi secara default.
— Migrasi: Sinkronisasi skema database dengan model Anda — ini sihir yang menghemat berjam-jam rutinitas.
— Logika Domain: Ideal untuk sistem e-commerce yang kompleks dan admin, di mana hubungan antar tabel lebih rumit dari plot "Interstellar".

❌ Apa jebakannya:
— Overhead: Pemetaan objek adalah operasi yang mahal. Pada dataset besar (100k+ baris), Anda akan merasakan proses Python mulai memakan memori dan CPU.
— Masalah N+1: Pembunuh performa utama. Satu .joinedload() yang terlupakan — dan layanan Anda ambruk di bawah hujan permintaan kecil.

🪑 Kursi #2: Raw SQL / asyncpg (Pilihan untuk Highload)

Ketika Anda terbentur performa, lapisan perantara mulai mengganggu.

✅ Mengapa ini keren:
— Kecepatan ekstrem: Perbedaan 2,5 kali lipat bukan lelucon. Protokol biner asyncpg memungkinkan Anda memaksimalkan saluran jaringan.
— Kontrol penuh: Anda menulis SQL yang persis akan masuk ke penjadwal database. Tidak ada sihir tambahan dari ORM.
— Fitur database spesifik: Coba gunakan JSONB atau indeks Postgres spesifik secara efisien melalui ORM — kadang ini berubah menjadi kerja sia-sia.

❌ Apa jebakannya:
— Tanggung jawab Anda: Lupa melakukan escape parameter? Selamat, database bocor.
— Boilerplate: Anda harus memetakan tuple dari database ke model DTO/Pydantic secara manual. Ini membosankan dan menimbulkan kesalahan.
— Pemeliharaan: Membaca 500 baris SQL mentah dalam kode setelah enam bulan — kesenangan yang meragukan.


💡 Putusan: Standar emas — pendekatan hibrida

Tidak perlu memilih salah satu. Arsitektur modern terlihat seperti ini:
1. SQLAlchemy ORM — untuk 90% tugas: CRUD, logika bisnis, migrasi, dan admin.
2. SQLAlchemy Core — ketika objek ORM terlalu berat, tetapi Anda belum ingin menulis string mentah.
3. Raw SQL (asyncpg) — untuk titik-titik sempit: laporan analitis, insert massal, dan mikrolayanan dengan beban 10k+ RPS.

Pilih kursi sesuai ukuran beban ☝️

Dan Anda menggunakan yang mana?
👨‍💻 Hanya ORM, hidup terlalu singkat untuk menulis SQL dengan tangan.
👨‍💻 Hanya Raw SQL, tidak percaya pada sihir ini.

#dua_kursi