Belajar Drizzle ORM - Relational Queries & Relations Definition

#Pendahuluan

Setelah di episode 6 kita mempelajari Advanced Select — filtering, sorting, pagination, dan aggregations — pada episode ini kita masuk ke relational queries: mendefinisikan relasi antar tabel dan melakukan nested queries yang mengambil data dari beberapa tabel sekaligus.

Relational queries adalah fitur yang membedakan Drizzle ORM dari sekadar query builder — ia memungkinkan kalian mendapatkan data yang sudah di-nested tanpa menulis JOIN manual.

#Defining Relations

#one() — Belongs To / Has One

Definisi relasi one-to-many

import { relations } from 'drizzle-orm'
 
export const usersRelations = relations(users, ({ many }) => ({
  posts: many(posts),
}))
 
export const postsRelations = relations(posts, ({ one }) => ({
  author: one(users, {
    fields: [posts.authorId],
    references: [users.id],
  }),
}))

many() — user punya banyak posts (one-to-many).
one() — post punya satu author (many-to-one).

#Penjelasan

fields — kolom di tabel ini yang menjadi foreign key.
references — kolom di tabel target yang dirujuk.

#Nested Relational Queries

#findMany dengan with

Nested query: users dengan posts-nya

const usersWithPosts = await db.query.users.findMany({
  with: {
    posts: true,
  },
})

Hasilnya:

json

[
  {
    "id": 1,
    "name": "John",
    "posts": [
      { "id": 1, "title": "Hello World" },
      { "id": 2, "title": "Drizzle ORM" }
    ]
  }
]

#Filter di Nested Query

Filter nested posts

const usersWithPopularPosts = await db.query.users.findMany({
  with: {
    posts: {
      where: gt(posts.viewCount, 50),
      orderBy: desc(posts.publishedAt),
      limit: 5,
    },
  },
  where: eq(users.isActive, true),
})

#findFirst

Ambil satu user dengan posts-nya

const user = await db.query.users.findFirst({
  with: {
    posts: true,
  },
  where: eq(users.id, 1),
})

#Kapan Pakai Relational Queries vs SQL-like Queries

Aspek	Relational Queries	SQL-like Queries
Data shape	Nested (Prisma-like)	Flat atau custom join
Complexity	Sederhana hingga menengah	Kompleks, many-to-many
Performance	Sangat baik (optimized JOIN)	Full control
Use case	API responses, dashboard	Reports, analytics

#Contoh Many-to-Many

Many-to-many dengan junction table

export const usersToGroups = pgTable('users_to_groups', {
  userId: integer('user_id').references(() => users.id),
  groupId: integer('group_id').references(() => groups.id),
})
 
export const usersRelations = relations(users, ({ many }) => ({
  groups: many(usersToGroups),
}))

Tip

Relational queries sangat cocok untuk API responses yang membutuhkan data nested. SQL-like queries lebih cocok untuk reports dan analytics yang membutuhkan custom joins dan aggregations kompleks. Keduanya bisa digunakan bersamaan dalam proyek yang sama.

#Penutup

Pada episode 7 ini, kalian telah memahami Relational Queries:

relations() mendefinisikan relasi antar tabel: one() dan many().
findMany({ with: {...} }) untuk nested queries.
Filter bisa diterapkan di nested level dengan where, orderBy, limit.
Relational queries untuk data nested (API), SQL-like queries untuk reports.

Di episode 8 selanjutnya kita akan mempelajari SQL-like JOIN Queries — inner join, left join, multi-table join, dan join conditions. Sampai jumpa di episode 8!