Content Collections & data eksternal

Content Collections dirancang untuk konten yang ada saat build. Portal beritamu tidak seperti itu — tapi ada bagian yang cocok, dan satu fitur baru yang mengubah perhitungannya.

Apa yang sebenarnya diberikan Content Collections

Tiga hal: skema bertipe dengan Zod, pemuatan dari sumber apa pun lewat loader, dan API kueri yang seragam. Ia dirancang untuk konten yang jumlahnya terkelola dan berubah pada kecepatan manusia — bukan untuk arsip berita ratusan ribu entri.

// src/content.config.ts
import { defineCollection, z } from "astro:content";
import { glob } from "astro/loaders";

const kebijakan = defineCollection({
  loader: glob({ pattern: "**/*.md", base: "./src/konten/kebijakan" }),
  schema: z.object({
    judul: z.string(),
    diperbaruiPada: z.coerce.date(),
    ringkasan: z.string().optional(),
  }),
});

export const collections = { kebijakan };

---
import { getCollection, render } from "astro:content";

export const prerender = true;

export async function getStaticPaths() {
  const semua = await getCollection("kebijakan");
  return semua.map((e) => ({ params: { slug: e.id }, props: { entri: e } }));
}

const { entri } = Astro.props;
const { Content } = await render(entri);
---
<h1>{entri.data.judul}</h1>
<Content />

Loader kustom dari MySQL

// Bisa dilakukan — tapi baca peringatannya di bawah
import type { Loader } from "astro/loaders";

function loaderPenulis(): Loader {
  return {
    name: "penulis-mysql",
    load: async ({ store, parseData, logger }) => {
      const baris = await dbBaca
        .selectFrom("member")
        .select(["id", "nama", "bio", "foto"])
        .where("peran", "in", ["penulis", "editor"])
        .execute();

      store.clear();
      for (const p of baris) {
        const data = await parseData({ id: String(p.id), data: p });
        store.set({ id: String(p.id), data });
      }
      logger.info(`memuat ${baris.length} penulis`);
    },
  };
}

Ini masuk akal untuk penulis: jumlahnya puluhan, berubah jarang, dan halaman profilnya layak di-prerender. Ini tidak masuk akal untuk artikel: 200 ribu entri akan dimuat ke penyimpanan collection setiap build, dan artikel baru tetap butuh build ulang untuk muncul.

Live collections — yang mengubah perhitungan

Astro punya live content collections yang mengambil data saat request, bukan saat build. Ini menutup celah untuk sumber eksternal yang berubah terus:

// src/live.config.ts
import { defineLiveCollection } from "astro:content";
import { loaderDataPasar } from "@/lib/loader-pasar";

export const collections = {
  pasar: defineLiveCollection({ loader: loaderDataPasar() }),
};

---
import { getLiveCollection } from "astro:content";

export const prerender = false;

const { entries, error } = await getLiveCollection("pasar");
if (error) {
  console.error(error);
}
---
{entries?.map((e) => <BarisPasar data={e.data} />)}

Peta keputusan untuk portalmu

Pola yang muncul: collection untuk konten yang hidup di git; fungsi lib/ untuk data yang hidup di database. Itu pembagian yang bertahan.