Belajar Drizzle ORM - Introspection & Existing Database

#Pendahuluan

Setelah di episode 10 kita mempelajari Drizzle Kit Migrations — generate, review, dan apply migration — pada episode ini kita membahas introspection: bagaimana menghasilkan TypeScript schema dari database yang sudah ada.

Banyak proyek tidak dimulai dari nol — database sudah ada, tabel sudah dibuat, dan data sudah terisi. Introspection memungkinkan kalian mengadopsi Drizzle ORM tanpa harus menulis ulang schema dari awal.

#Mengapa Introspection Diperlukan

#Legacy Database Migration

Proyek lama menggunakan raw SQL atau ORM lain (Sequelize, TypeORM). Database sudah berisi banyak tabel dengan data production. Kalian tidak bisa membuat ulang schema dari awal — harus mengikuti apa yang sudah ada.

#Database yang Dikelola DBA

Di banyak perusahaan, database dikelola oleh DBA (Database Administrator) secara terpisah. Developer tidak punya akses untuk membuat tabel — mereka hanya punya akses query. Introspection memungkinkan generate schema dari database yang dikelola DBA.

#Introspection Command

Introspect database existing

npx drizzle-kit introspect

Drizzle Kit akan:

Menghubungkan ke database.
Membaca struktur semua tabel.
Generate TypeScript schema yang merepresentasikan tabel-tabel tersebut.

#Output

plaintext

src/db/schema/
  users.ts
  posts.ts
  comments.ts
  index.ts

Setiap tabel menghasilkan satu file schema TypeScript.

#Setup dari Database Existing

#Langkah 1: Hubungkan ke Database

Pastikan drizzle.config.ts sudah dikonfigurasi dengan benar:

drizzle.config.ts untuk introspection

import { defineConfig } from 'drizzle-kit'
 
export default defineConfig({
  schema: './src/db/schema/*',
  out: './drizzle',
  dialect: 'postgresql',
  dbCredentials: {
    url: process.env.DATABASE_URL!,
  },
})

#Langkah 2: Jalankan Introspection

Jalankan introspection

npx drizzle-kit introspect

#Langkah 3: Review Generated Schema

Penting: selalu review generated schema. Pastikan:

Tipe data sudah benar (text, integer, boolean, dll).
Primary keys dan foreign keys terdeteksi.
Default values sesuai.
Column names sesuai.

#Langkah 4: Gunakan Schema untuk Queries

Setelah review, schema bisa langsung digunakan untuk queries:

Query dengan schema hasil introspection

import { db } from './db'
import { users } from './db/schema'
 
const allUsers = await db.select().from(users)

#Kapan Introspection Diperlukan

Skenario	Gunakan Introspection?
Legacy database migration ke Drizzle	Ya
Database dikelola DBA	Ya
Proyek baru dari nol	Tidak — tulis schema manual
Testing dengan SQLite in-memory	Tidak — push langsung

Tip

Introspection adalah starting point, bukan final state. Setelah generate schema, kalian bisa menambahkan relasi, index, dan customizations sesuai kebutuhan proyek.

#Penutup

Pada episode 11 ini, kalian telah memahami Introspection:

npx drizzle-kit introspect generate TypeScript schema dari database existing.
Kapan digunakan: legacy database, database dikelola DBA, migrasi dari ORM lain.
Workflow: hubungkan → introspect → review → gunakan.
Review generated schema sebelum digunakan — pastikan tipe data dan struktur benar.

Di episode 12 selanjutnya kita akan mempelajari Drizzle Studio: Visual Database Browser — GUI untuk browse, edit, dan filter data langsung di browser. Sampai jumpa di episode 12!