Pernah nggak sih, kamu sudah capek-capek bikin query SQL manual, eh pas ganti database ternyata syntax-nya beda lagi? Atau mungkin kamu sering lupa nama kolom di tabel, lalu harus bolak-balik cek console database? Kalau iya, selamat — kamu bukan sendirian. Dulu saya juga begitu, dan Prisma ORM benar-benar mengubah cara saya bekerja dengan database.
Di panduan ini, saya mau berbagi semua yang saya pelajari tentang Prisma ORM — dari nol banget, sampai kamu bisa bikin aplikasi yang terhubung ke database dengan elegan. Nggak perlu background database expert. Yang kamu butuhkan cuma dasar JavaScript/TypeScript dan keingintahuan.
Yuk, mulai.
Apa Itu Prisma ORM dan Kenapa Kamu Harus Peduli?
Sebelum masuk ke kode, mari kita pahami dulu konsep dasarnya.
ORM itu singkatan dari Object-Relational Mapping. Bayangkan begini: database kamu berbicara dalam bahasa SQL (tabel, baris, kolom), sementara kode JavaScript/TypeScript kamu berbicara dalam bahasa objek dan fungsi. ORM jadi “penerjemah” antara keduanya. Kamu tulis kode JavaScript biasa, ORM yang urus translasinya ke SQL.
Prisma adalah ORM modern yang dibangun khusus untuk ekosistem Node.js dan TypeScript. Berbeda dengan ORM lawas seperti Sequelize atau TypeORM, Prisma punya beberapa keunggulan yang bikin hidup developer jauh lebih mudah:
- Type Safety yang Luar Biasa — Kalau kamu pakai TypeScript, Prisma otomatis generate tipe berdasarkan schema database kamu. Salah ketik nama field? Langsung kena warning di editor.
- Prisma Client yang Auto-Generated — Kamu nggak perlu mendefinisikan model manual. Prisma baca schema, lalu generate client yang bisa kamu pakai langsung.
- Prisma Studio — GUI visual untuk lihat dan edit data di database, tanpa perlu buka DBeaver atau pgAdmin.
- Migrasi yang Terstruktur — Perubahan schema tercatat rapi sebagai file migrasi, jadi kamu bisa track perubahan database seperti track perubahan kode di Git.
Kalau di tahun 2026 ini kamu mau serius di backend development dengan Node.js, Prisma sudah jadi standar industri yang nggak bisa diabaikan. Banyak perusahaan besar dan startup mengadopsinya karena produktivitas dan keamanan tipe yang ditawarkan.
Instalasi dan Setup Prisma dari Nol
Oke, langsung praktik. Saya akan bimbing kamu langkah demi langkah.
Persiapan Awal
Pastikan kamu sudah punya:
- Node.js versi 18 atau lebih baru
- npm atau pnpm (saya prefer pnpm, tapi terserah kamu)
- Database — bisa PostgreSQL, MySQL, SQLite, MongoDB, atau SQL Server. Di panduan ini, saya pakai PostgreSQL karena paling populer di produksi.
Buat project baru kalau belum ada:
mkdir belajar-prisma
cd belajar-prisma
npm init -y
npm install prisma typescript ts-node @types/node --save-dev
npx tsc --init
Inisialisasi Prisma
Satu command ini akan membuat folder prisma dan file schema.prisma:
npx prisma init --datasource-provider postgresql
Setelah dijalankan, kamu akan dapat output seperti ini:
Buka file .env dan isi connection string database kamu:
DATABASE_URL="postgresql://username:password@localhost:5432/belajar_prisma?schema=public"
Ganti username, password, dan belajar_prisma sesuai setup database kamu. Kalau pakai Docker, jalankan PostgreSQL dulu:
docker run --name prisma-postgres -e POSTGRES_USER=admin -e POSTGRES_PASSWORD=rahasia -e POSTGRES_DB=belajar_prisma -p 5432:5432 -d postgres:16
Memahami Schema Prisma: Jantung dari Segalanya
File schema.prisma ini adalah pusat dari segalanya. Di sinilah kamu mendefinisikan struktur database kamu. Kalau di SQL tradisional, ini setara dengan menulis CREATE TABLE. Bedanya, Prisma pakai bahasa deklaratif yang lebih manusiawi.
Buka prisma/schema.prisma dan ubah jadi seperti ini:
generator client {
provider = "prisma-client-js"
}
datasource db {
provider = "postgresql"
url = env("DATABASE_URL")
}
model User {
id Int @id @default(autoincrement())
email String @unique
name String?
createdAt DateTime @default(now())
updatedAt DateTime @updatedAt
posts Post[]
}
model Post {
id Int @id @default(autoincrement())
title String
content String?
published Boolean @default(false)
author User @relation(fields: [authorId], references: [id])
authorId Int
createdAt DateTime @default(now())
updatedAt DateTime @updatedAt
tags Tag[]
}
model Tag {
id Int @id @default(autoincrement())
name String @unique
posts Post[]
}
Mari kita bedah satu per satu:
model User— Mendefinisikan tabelUserdengan kolomid,email,name,createdAt, danupdatedAt.@id— Menandai kolom sebagai primary key.@default(autoincrement())— Nilai default yang naik otomatis setiap insert.@unique— Membuat constraint unique, nggak boleh ada duplikat.String?— Tanda tanya berarti field ini nullable (boleh kosong).Post[]— Ini relasi one-to-many. Satu user bisa punya banyak post.@relation— Mendefinisikan relasi antar tabel. Di sini Post punya relasi ke User melaluiauthorId.
Yang bikin Prisma beda dari ORM lain: relasinya terbaca seperti bahasa manusia. Kamu nggak perlu pusing join table manual atau mendefinisikan foreign key di tempat terpisah.
Menjalankan Migrasi
Setelah schema siap, jalankan migrasi untuk benar-benar membuat tabel di database:
npx prisma migrate dev --name init
Command ini akan:
- Membuat file SQL migrasi di folder
prisma/migrations - Menjalankan migrasi ke database
- Men-generate Prisma Client secara otomatis
Kalau berhasil, outputnya kurang lebih:
Sekarang database kamu sudah punya tabel User, Post, dan Tag beserta relasinya. Tanpa menulis satu baris SQL pun.
CRUD dengan Prisma Client: Saatnya Ngoding
Ini bagian yang paling seru. Setelah schema terdefinisi dan migrasi dijalankan, Prisma Client siap dipakai. Mari kita coba operasi CRUD (Create, Read, Update, Delete).
Buat file src/index.ts:
import { PrismaClient } from "@prisma/client";
const prisma = new PrismaClient();
async function main() {
// === CREATE ===
// Membuat user baru
const user = await prisma.user.create({
data: {
email: "[email protected]",
name: "Budi Santoso",
},
});
console.log("User dibuat:", user);
// Membuat post dan langsung hubungkan ke user
const post = await prisma.post.create({
data: {
title: "Pengalaman Pertama Pakai Prisma",
content: "Jujur, lebih gampang dari yang saya kira...",
published: true,
author: {
connect: { id: user.id },
},
},
});
console.log("Post dibuat:", post);
// === READ ===
// Ambil semua user beserta post-nya
const usersWithPosts = await prisma.user.findMany({
include: {
posts: true,
},
});
console.log("Semua user + posts:", usersWithPosts);
// Cari user berdasarkan email
const foundUser = await prisma.user.findUnique({
where: { email: "[email protected]" },
include: { posts: true },
});
console.log("User ditemukan:", foundUser);
// Filter post yang sudah dipublish
const publishedPosts = await prisma.post.findMany({
where: { published: true },
orderBy: { createdAt: "desc" },
});
console.log("Post yang dipublish:", publishedPosts);
// === UPDATE ===
const updatedUser = await prisma.user.update({
where: { id: user.id },
data: { name: "Budi Santoso, S.Kom" },
});
console.log("User diupdate:", updatedUser);
// === DELETE ===
// Hapus post tertentu
await prisma.post.delete({
where: { id: post.id },
});
console.log("Post dihapus.");
}
main()
.catch((e) => {
console.error("Error:", e);
process.exit(1);
})
.finally(async () => {
await prisma.$disconnect();
});
Jalankan dengan:
npx ts-node src/index.ts
Lihat hasilnya di terminal. Nggak ada SQL manual, nggak ada string query yang typo. Semantiknya jelas: create, findMany, findUnique, update, delete. Semuanya type-safe.
Query yang Lebih Kompleks
Prisma juga mendukung query yang lebih advanced. Misalnya kamu mau cari post yang judulnya mengandung kata tertentu DAN belum dipublish, urutkan berdasarkan tanggal terbaru, ambil 5 data saja:
const draftPosts = await prisma.post.findMany({
where: {
title: { contains: "Prisma", mode: "insensitive" },
published: false,
},
orderBy: { createdAt: "desc" },
take: 5,
skip: 0,
include: {
author: {
select: { name: true, email: true },
},
},
});
mode: "insensitive" bikin pencarian nggak case-sensitive. take dan skip berguna untuk pagination. select dipakai kalau kamu cuma mau ambil field tertentu saja dari relasi, bukan semua field.
Kamu juga bisa pakai nested create untuk bikin user dan post sekaligus dalam satu operasi:
const userWithPosts = await prisma.user.create({
data: {
email: "[email protected]",
name: "Siti Rahayu",
posts: {
create: [
{ title: "Post Pertama Siti", published: true },
{ title: "Draft Siti", published: false },
],
},
},
include: { posts: true },
});
Efisien banget, kan? Dua post dibuat sekaligus dengan satu query.
Tips dan Best Practice Saat Pakai Prisma
Setelah cukup lama pakai Prisma di beberapa project, ada beberapa pelajaran yang ingin saya bagikan:
1. Selalu Tutup Koneksi dengan await prisma.$disconnect()
Kalau kamu bikin satu instance PrismaClient yang dipakai di banyak tempat, pastikan koneksi ditutup saat aplikasi berhenti. Kebocoran koneksi database itu masalah nyata di produksi. Untuk aplikasi Express atau Fastify, biasanya saya bikin satu file terpisah:
// src/lib/prisma.ts
import { PrismaClient } from "@prisma/client";
const globalForPrisma = globalThis as unknown as {
prisma: PrismaClient | undefined;
};
export const prisma = globalForPrisma.prisma ?? new PrismaClient();
if (process.env.NODE_ENV !== "production") {
globalForPrisma.prisma = prisma;
}
Ini memastikan di development (dengan hot reload), kamu nggak bikin koneksi baru setiap kali file di-reload.
2. Manfaatkan prisma migrate dev dengan Bijak
Saat iterasi schema selama development, prisma migrate dev --name nama_migrasi adalah teman terbaik kamu. Tapi hindari meng-edit file migrasi yang sudah dijalankan secara manual di production. Kalau perlu reset, pakai prisma migrate reset.
3. Pakai select atau include Secara Sadar
Jangan ambil semua field kalau kamu cuma butuh beberapa. Selain hemat bandwidth, ini juga soal keamanan — jangan sampai field sensitif seperti password hash terkirim ke frontend.
// Hindari ini kalau ada field sensitif
const user = await prisma.user.findUnique({ where: { id: 1 } });
// Lebih baik
const user = await prisma.user.findUnique({
where: { id: 1 },
select: { id: true, name: true, email: true },
});
4. Pakai Transaction untuk Operasi yang Harus Atomic
Misalnya kamu mau transfer saldo dari user A ke user B. Kedua operasi harus berhasil atau keduanya gagal. Prisma mendukung interactive transaction:
await prisma.$transaction(async (tx) => {
await tx.user.update({
where: { id: userA.id },
data: { balance: { decrement: 100000 } },
});
await tx.user.update({
where: { id: userB.id },
data: { balance: { increment: 100000 } },
});
});
Kalau ada error di tengah-tengah, semua perubahan di-rollback otomatis.
5. Pakai Prisma Studio untuk Debugging
Kadang kamu perlu lihat data langsung di database tanpa menulis query. Jalankan:
npx prisma studio
Browser akan terbuka di http://localhost:5555 dengan antarmuka visual untuk browse, filter, edit, dan hapus data. Ini sangat handy saat debugging.
Prisma dengan Next.js: Kombinasi yang Nggak Terbantahkan
Di ekosistem 2026, kombinasi Prisma + Next.js sudah jadi pilihan default banyak developer. Alasannya sederhana: Next.js butuh data fetching yang cepat dan type-safe, dan Prisma menyediakan tepat itu.
Di Next.js App Router, kamu bisa langsung pakai Prisma di Server Components:
// app/posts/page.tsx
import { prisma } from "@/lib/prisma";
export default async function PostsPage() {
const posts = await prisma.post.findMany({
where: { published: true },
include: { author: true },
orderBy: { createdAt: "desc" },
});
return (
<div>
<h1>Semua Post</h1>
{posts.map((post) => (
<article key={post.id}>
<h2>{post.title}</h2>
<p>oleh {post.author.name}</p>
</article>
))}
</div>
);
}
Tanpa API route, tanpa useEffect, tanpa loading state ribet. Data di-fetch langsung di server, rendered sebagai HTML, dan dikirim ke browser. Prisma berjalan di server — nggak pernah sampai ke client-side bundle.
Untuk API Routes, kamu bisa bikin endpoint yang menerima data dari form:
// app/api/posts/route.ts
import { prisma } from "@/lib/prisma";
import { NextRequest, NextResponse } from "next/server";
export async function POST(req: NextRequest) {
const body = await req.json();
const newPost = await prisma.post.create({
data: {
title: body.title,
content: body.content,
authorId: body.authorId,
},
});
return NextResponse.json(newPost, { status: 201 });
}
Bersih, sederhana, dan type-safe.
Butuh bantuan setup Prisma di project kamu, atau mau konsultasi arsitektur database? Jangan ragu hubungi saya di [email protected] — senang bisa ngobrol dan bantu troubleshoot.
FAQ: Pertanyaan yang Sering Ditanyakan tentang Prisma ORM
Apakah Prisma lebih baik dari Sequelize atau TypeORM?
Tergantung konteks. Tapi kalau kamu pakai TypeScript, Prisma unggul di type safety dan developer experience. Prisma Client di-generate otomatis dari schema, jadi kamu nggak perlu mendefinisikan interface manual. Sequelize lebih mature tapi kurang ramah TypeScript. TypeORM bagus tapi sering bikin bingung dengan dekorator dan API-nya yang agak kuno. Di 2026, Prisma adalah pilihan paling populer untuk project baru berbasis Node.js/TypeScript.
Apakah Prisma bisa dipakai dengan database yang sudah ada (existing database)?
Bisa banget. Jalankan npx prisma db pull untuk introspect database yang sudah ada. Prisma akan generate schema berdasarkan struktur tabel yang ada. Ini sangat berguna kalau kamu masuk ke project legacy dan mau mulai pakai Prisma tanpa bikin schema dari nol. Setelah schema ter-generate, review dan sesuaikan, lalu jalankan prisma generate untuk bikin client.
Apakah Prisma mendukung raw SQL?
Ya, kalau kamu butuh query yang sangat kompleks dan nggak bisa di-ekspresikan lewat Prisma Client, kamu bisa pakai $queryRaw atau $executeRaw:
const results = await prisma.$queryRaw`
SELECT * FROM "Post"
WHERE "title" ILIKE ${'%prisma%'}
AND "createdAt" > NOW() - INTERVAL '30 days'
`;
Ini berguna untuk query analytics, window function, atau fitur database spesifik yang belum didukung Prisma Client secara native. Tapi sebisa mungkin, pakai Prisma Client dulu karena lebih aman dan type-safe.
Bagaimana cara handle seeding data di Prisma?
Buat file prisma/seed.ts dan konfigurasi di package.json:
{
"prisma": {
"seed": "ts-node prisma/seed.ts"
}
}
Lalu isi file seed:
import { PrismaClient } from "@prisma/client";
const prisma = new PrismaClient();
async function main() {
await prisma.user.create({
data: {
email: "[email protected]",
name: "Admin",
posts: {
create: [
{ title: "Post Pertama", content: "Hello World!", published: true },
],
},
},
});
}
main()
.catch(console.error)
.finally(() => prisma.$disconnect());
Jalankan dengan npx prisma db seed.
Penutup
Prisma ORM di tahun 2026 bukan lagi sekadar alternatif — ini sudah jadi pilihan utama bagi developer yang menghargai produktivitas dan keamanan tipe. Dari schema deklaratif yang gampang dibaca, migrasi yang terstruktur, client yang auto-generated, sampai Prisma Studio untuk debugging visual — semuanya dirancang untuk bikin hidup kamu lebih mudah.
Kalau kamu baru mulai belajar backend development, Prisma adalah ORM yang sangat ramah pemula. Dan kalau kamu sudah berpengalaman dengan ORM lain, saya jamin transisi ke Prisma akan terasa seperti upgrade yang signifikan.
Mulai dari schema sederhana, eksplorasi fitur satu per satu, dan yang paling penting: jangan takut untuk bereksperimen. Database yang kamu hancurkan di development bukan masalah besar — itulah gunanya prisma migrate reset.
Selamat ngoding, dan semoga panduan ini membantu! 🚀