Playground embedded open source perlu menyimpan contoh kode yang dapat dibagikan dan, bila diperlukan, riwayat eksekusinya. Skema awal sebaiknya menjaga contoh tetap terpisah dari eksekusi: contoh adalah konten yang relatif stabil, sedangkan eksekusi dapat bertambah cepat dan memiliki kebutuhan retensi berbeda.

Panduan ini menyajikan skema minimal yang dapat diterapkan pada SQLite maupun PostgreSQL, query daftar dengan filter dan pagination, serta rencana pengujian pertumbuhan data sintetis. Konteksnya adalah proyek kecil yang dapat direproduksi dan dikontribusikan komunitas, bukan klaim tentang struktur internal proyek pada artikel rujukan.

Rancang batas data sebelum memilih database

Mulai dengan dua entitas. examples menyimpan kode yang dapat dimuat kembali. executions menyimpan percobaan menjalankan contoh, termasuk status dan waktu eksekusi. Relasi ini memungkinkan contoh tetap tersedia ketika riwayat lama dibersihkan.

  • Simpan kode sebagai teks; hindari menganggap semua bahasa memiliki format atau struktur yang sama.
  • Simpan waktu dalam UTC dengan format yang konsisten. SQLite tidak memiliki tipe timestamp khusus, sedangkan PostgreSQL menyediakan tipe waktu bertipe.
  • Jangan menyimpan output tanpa batas. Tetapkan batas ukuran atau kebijakan retensi agar eksekusi tidak menghabiskan ruang penyimpanan.
  • Jangan menyimpan rahasia, token, atau data sensitif dalam kode dan output tanpa kebutuhan serta kebijakan yang jelas.

Contoh berikut memakai ID integer, slug unik, bahasa, kode, dan waktu pembuatan. Tipe waktu sengaja berbeda agar sesuai dengan kemampuan masing-masing database.

Skema SQLite

PRAGMA foreign_keys = ON;

CREATE TABLE examples (
    id INTEGER PRIMARY KEY,
    slug TEXT NOT NULL UNIQUE,
    title TEXT NOT NULL,
    language TEXT NOT NULL,
    code TEXT NOT NULL,
    created_at TEXT NOT NULL
);

CREATE TABLE executions (
    id INTEGER PRIMARY KEY,
    example_id INTEGER NOT NULL REFERENCES examples(id) ON DELETE CASCADE,
    status TEXT NOT NULL CHECK (status IN ('succeeded', 'failed', 'timed_out')),
    duration_ms INTEGER NOT NULL CHECK (duration_ms >= 0),
    output TEXT,
    created_at TEXT NOT NULL
);

Skema PostgreSQL

CREATE TABLE examples (
    id BIGINT GENERATED BY DEFAULT AS IDENTITY PRIMARY KEY,
    slug TEXT NOT NULL UNIQUE,
    title TEXT NOT NULL,
    language TEXT NOT NULL,
    code TEXT NOT NULL,
    created_at TIMESTAMPTZ NOT NULL
);

CREATE TABLE executions (
    id BIGINT GENERATED BY DEFAULT AS IDENTITY PRIMARY KEY,
    example_id BIGINT NOT NULL REFERENCES examples(id) ON DELETE CASCADE,
    status TEXT NOT NULL CHECK (status IN ('succeeded', 'failed', 'timed_out')),
    duration_ms INTEGER NOT NULL CHECK (duration_ms >= 0),
    output TEXT,
    created_at TIMESTAMPTZ NOT NULL
);

SQLite menerima waktu sebagai teks; gunakan nilai UTC dengan format ISO 8601 yang konsisten, misalnya 2025-01-15T12:30:00Z. PostgreSQL dapat menyimpan waktu berzona waktu melalui TIMESTAMPTZ. Aplikasi tetap perlu menggunakan UTC secara konsisten. ON DELETE CASCADE membuat penghapusan contoh juga menghapus eksekusinya; hapus aturan tersebut jika riwayat harus dipertahankan.

Query daftar, filter, dan pagination

Untuk daftar contoh terbaru, gunakan pagination berbasis cursor yang terdiri dari created_at dan id. ID menjadi pemecah seri saat beberapa baris memiliki waktu pembuatan yang sama. Dibanding offset, cursor tidak perlu melewati semua baris sebelumnya ketika halaman makin jauh, dan lebih stabil ketika data baru masuk.

SELECT id, slug, title, language, created_at
FROM examples
WHERE language = :language
  AND (created_at, id) < (:cursor_created_at, :cursor_id)
ORDER BY created_at DESC, id DESC
LIMIT :page_size;

Untuk halaman pertama, hilangkan kondisi cursor. Gunakan parameter terikat, bukan menyisipkan nilai filter ke dalam string SQL. Sintaks placeholder bergantung pada driver: SQLite mendukung parameter bernama, sedangkan driver PostgreSQL umumnya memakai placeholder posisional. Sesuaikan query dengan driver yang dipakai.

Query tersebut memakai perbandingan baris untuk cursor. Jika lapisan akses data tidak mendukung bentuk itu pada kedua driver, tulis kondisi ekuivalen: created_at < :cursor_created_at OR (created_at = :cursor_created_at AND id < :cursor_id). Pastikan representasi waktu cursor mengikuti format yang sama dengan kolom.

Ambil satu baris lebih banyak daripada ukuran halaman jika aplikasi perlu memastikan apakah halaman berikutnya tersedia. Buat cursor berikutnya dari baris terakhir yang benar-benar dikirim, bukan dari baris tambahan tersebut.

Indeks dan pengujian SQL

Indeks harus mengikuti pola query yang benar-benar digunakan. Indeks gabungan ini mendukung filter berdasarkan bahasa sekaligus pengurutan terbaru:

CREATE INDEX examples_language_created_id_idx
ON examples (language, created_at DESC, id DESC);

Indeks foreign key pada tabel anak juga berguna untuk pencarian riwayat dan operasi cascade:

CREATE INDEX executions_example_created_id_idx
ON executions (example_id, created_at DESC, id DESC);

Indeks menambah biaya penulisan dan penyimpanan. Jangan menambahkan indeks untuk setiap kolom; mulai dari indeks yang mendukung query utama, lalu verifikasi dengan rencana query. Pada PostgreSQL, gunakan EXPLAIN (ANALYZE, BUFFERS) untuk mengukur eksekusi query. Pada SQLite, gunakan EXPLAIN QUERY PLAN untuk melihat rencana yang dipilih. Hasil rencana tidak menjamin performa di semua ukuran data, jadi uji dengan volume yang mendekati penggunaan nyata.

Uji data sintetis dan ukur pertumbuhan

Gunakan data sintetis untuk memeriksa validitas skema, query, serta dampak indeks sebelum memasukkan data produksi. Buat variasi bahasa, ukuran kode, jumlah eksekusi per contoh, dan tanggal. Jangan mengandalkan satu distribusi seragam jika pola nyata cenderung memiliki contoh populer dengan banyak eksekusi.

Contoh generator PostgreSQL

INSERT INTO examples (slug, title, language, code, created_at)
SELECT
    'sample-' || n,
    'Sample ' || n,
    CASE WHEN n % 2 = 0 THEN 'typescript' ELSE 'go' END,
    'print(' || n || ')',
    TIMESTAMPTZ '2025-01-01 00:00:00+00' + n * INTERVAL '1 second'
FROM generate_series(1, 10000) AS n;

Contoh generator SQLite

WITH RECURSIVE numbers(n) AS (
    SELECT 1
    UNION ALL
    SELECT n + 1 FROM numbers WHERE n < 10000
)
INSERT INTO examples (slug, title, language, code, created_at)
SELECT
    'sample-' || n,
    'Sample ' || n,
    CASE WHEN n % 2 = 0 THEN 'typescript' ELSE 'go' END,
    'print(' || n || ')',
    strftime('%Y-%m-%dT%H:%M:%SZ', '2025-01-01', '+' || n || ' seconds')
FROM numbers;

Untuk menguji pagination, jalankan query halaman pertama dan halaman lanjutan, lalu pastikan tidak ada duplikasi atau baris yang terlewat ketika waktu pembuatan sama. Tambahkan data baru di antara pengambilan halaman untuk menguji kestabilan cursor. Uji juga filter yang tidak menghasilkan baris dan nilai filter yang tidak dikenal.

Ukur waktu query, ukuran database, serta ukuran indeks pada beberapa jumlah baris, misalnya 10 ribu, 100 ribu, dan lebih besar jika sesuai target penggunaan. Catat kondisi mesin, konfigurasi, ukuran kode, jumlah eksekusi, dan apakah cache hangat atau dingin. Angka ini membantu membandingkan perubahan pada lingkungan yang sama; angka dari mesin berbeda bukan tolok ukur langsung.

SQLite menyediakan PRAGMA page_count dan PRAGMA page_size untuk memperkirakan ukuran berkas basis data; ukuran berkas pada sistem operasi juga dapat diperiksa. PostgreSQL menyediakan pg_total_relation_size('examples') untuk mengukur ruang tabel beserta indeksnya. Jalankan pengukuran sesudah data dan indeks terbentuk, lalu ulangi setelah penghapusan atau perubahan skema. Perilaku ruang yang sudah digunakan dapat berbeda, sehingga jangan menyimpulkan bahwa penghapusan baris selalu langsung mengecilkan berkas.

Memilih SQLite atau PostgreSQL

  • SQLite cocok untuk aplikasi kecil yang membutuhkan basis data embedded, distribusi sederhana, dan akses penulisan yang relatif ringan. Operasionalnya sederhana karena data berada dalam berkas. Namun, pola banyak penulis bersamaan dapat menjadi batas; ukur beban tulis yang sesungguhnya.
  • PostgreSQL cocok ketika layanan perlu berbagi basis data melalui server, menangani akses bersamaan dari banyak klien, atau menggunakan kemampuan operasional dan query yang lebih luas. Pilihan ini membawa kebutuhan pengelolaan layanan, koneksi, backup, dan migrasi.

Keduanya tidak otomatis menentukan arsitektur proyek. Ukur beban, pola akses, kebutuhan backup, dan cara deployment sebelum berpindah database. Jaga skema serta query pada irisan fitur yang diperlukan jika aplikasi memang harus mendukung keduanya, dan jalankan pengujian integrasi pada masing-masing engine karena tipe waktu, placeholder, indeks, serta detail sintaks tidak selalu identik.

Kapan mengubah skema atau database

Ubah skema ketika kebutuhan query atau aturan data berubah, bukan hanya karena jumlah baris bertambah. Contohnya, tambahkan kolom status publikasi jika daftar harus membedakan draft dan publik; tambahkan indeks setelah rencana query dan pengukuran menunjukkan kebutuhan. Pisahkan output eksekusi ke penyimpanan lain hanya jika ukuran, retensi, atau pola akses membenarkannya.

Pertimbangkan PostgreSQL jika pengukuran menunjukkan SQLite tidak memenuhi pola penulisan bersamaan atau kebutuhan deployment bersama. Sebaliknya, pertahankan SQLite jika batas kinerja belum tercapai dan kesederhanaan embedded lebih bernilai. Sebelum migrasi, siapkan migrasi skema yang dapat diuji, salinan data cadangan, pemeriksaan jumlah baris, dan verifikasi hasil query setelah pemindahan.

Untuk playground komunitas, skema minimal dan pengukuran berulang lebih berguna daripada abstraksi dini. Mulai dengan pemisahan contoh dan eksekusi, indeks sesuai query daftar, batas retensi yang jelas, lalu ubah desain ketika bukti penggunaan menunjukkan batasnya.