SELECT, JOIN & relasi bersarang

Bagian ini yang paling terasa akrab. Yang baru cuma satu: cara mengambil tag dan penulis sekaligus tanpa membangunkan N+1.

Peta method

Tiga cara mengeksekusi

const semua = await q.execute();                 // Artikel[]
const satu  = await q.executeTakeFirst();        // Artikel | undefined
const wajib = await q.executeTakeFirstOrThrow(); // Artikel, atau melempar

Pilih yang ketiga hanya kalau ketiadaan baris benar-benar bug — misalnya mengambil pengaturan situs yang pasti ada. Untuk artikel berdasarkan slug, gunakan yang kedua dan tangani undefined dengan 404; melempar akan menghasilkan 500, dan 500 untuk artikel yang tidak ada adalah sinyal yang salah bagi mesin pencari maupun bagi pemantauanmu.

Kueri daftar artikel yang lengkap

// src/lib/artikel.ts
export async function ambilArtikelTerbaru(kategoriSlug: string, batas = 20) {
  let q = db
    .selectFrom("artikel as a")
    .innerJoin("member as p", "p.id", "a.penulis_id")
    .leftJoin("kategori as k", "k.id", "a.kategori_id")
    .select([
      "a.id", "a.judul", "a.slug", "a.ringkasan",
      "a.premium", "a.terbit_pada",
      "p.nama as penulis",
      "k.nama as kategori",
      "k.slug as kategoriSlug",
    ])
    .where("a.status", "=", "terbit")
    .where("a.terbit_pada", "<=", new Date())
    .orderBy("a.terbit_pada", "desc")
    .limit(batas);

  if (kategoriSlug !== "semua") {
    q = q.where("k.slug", "=", kategoriSlug);
  }

  return q.execute();
}

Dua hal yang layak diperhatikan:

• Kueri bisa dibangun bertahap. q = q.where(…) mengembalikan kueri baru; ia tidak mengubah yang lama. Ini pengganti langsung untuk if di sekitar $this->db->where() di CI3, tapi tanpa efek samping tersembunyi pada objek query builder global yang sama.
• terbit_pada <= sekarang bukan detail kecil. Portal berita menjadwalkan artikel. Tanpa syarat ini, artikel yang dijadwalkan terbit besok pagi akan tampil sekarang — bocor sebelum embargo.

Tipe hasilnya sudah benar tanpa kamu menuliskannya: penulis bertipe string (inner join), kategori bertipe string | null (left join). Compiler akan memaksamu menangani kemungkinan artikel tanpa kategori.

Kondisi OR dan bersarang

const hasil = await db
  .selectFrom("artikel")
  .selectAll()
  .where("status", "=", "terbit")
  .where((eb) =>
    eb.or([
      eb("judul", "like", `%${kata}%`),
      eb("ringkasan", "like", `%${kata}%`),
    ]),
  )
  .execute();

where berantai selalu AND. OR harus eksplisit — dan itu disengaja. Di CI3, or_where() yang bercampur dengan where() menghasilkan pengelompokan yang tidak selalu seperti yang kamu kira, dan bug otorisasi paling berbahaya lahir dari sana: WHERE pemilik = 5 AND status = 'draf' OR status = 'terbit' memberikan seluruh artikel terbit kepada siapa pun.

Relasi bersarang tanpa N+1

Masalah klasik: menampilkan 20 artikel, masing-masing dengan daftar tag.

// BURUK: 1 + 20 kueri
const artikel = await ambilArtikelTerbaru("semua", 20);
for (const a of artikel) {
  a.tag = await ambilTag(a.id);      // satu kueri per artikel
}

// BAIK: satu kueri
import { jsonArrayFrom } from "kysely/helpers/mysql";

const artikel = await db
  .selectFrom("artikel as a")
  .select((eb) => [
    "a.id", "a.judul", "a.slug",
    jsonArrayFrom(
      eb.selectFrom("artikel_tag as at")
        .innerJoin("tag as t", "t.id", "at.tag_id")
        .select(["t.id", "t.nama", "t.slug"])
        .whereRef("at.artikel_id", "=", "a.id"),
    ).as("tag"),
  ])
  .where("a.status", "=", "terbit")
  .orderBy("a.terbit_pada", "desc")
  .limit(20)
  .execute();

artikel[0].tag[0].nama;   // bertipe string

jsonArrayFrom memakai JSON_ARRAYAGG milik MySQL. Hasilnya sudah berupa array objek bertipe — Kysely yang mengurus parsing JSON-nya. Impor helper-nya dari kysely/helpers/mysql, bukan dari kysely/helpers/postgres; keduanya ada dan hanya berbeda di implementasinya.

Menghitung total untuk paginasi

const { total } = await db
  .selectFrom("artikel")
  .select((eb) => eb.fn.countAll<number>().as("total"))
  .where("status", "=", "terbit")
  .executeTakeFirstOrThrow();

Melihat SQL yang dihasilkan

const { sql, parameters } = q.compile();
console.log(sql, parameters);

Lakukan ini setiap kali kamu ragu. Salah satu keuntungan terbesar Kysely dibanding ORM adalah SQL-nya selalu bisa kamu lihat dan tempelkan ke EXPLAIN — tanpa menjalankan kuerinya.