Untuk mengetahui apakah indeks memperbaiki query yang melambat saat data bertambah, bandingkan hasil EXPLAIN ANALYZE sebelum dan sesudah perubahan dalam kondisi yang setara. Laporan HTML statis membantu menampilkan waktu eksekusi, jumlah baris, dan jenis pemindaian berdampingan, tanpa menambahkan aplikasi pelaporan.
Contoh berikut memakai PostgreSQL dan query pagination berdasarkan tenant. HTML dibuat ringkas dengan elemen semantik, tabel, dan CSS sederhana agar hasil mudah diperiksa serta dibagikan.
Siapkan perbandingan yang adil
Gunakan database, jumlah dan distribusi data, parameter query, serta kondisi beban yang sebanding. Jalankan query beberapa kali bila perlu; eksekusi pertama dapat dipengaruhi cache. Jangan membandingkan satu eksekusi dingin dengan satu eksekusi hangat seolah-olah hanya indeks yang berubah.
EXPLAIN ANALYZE benar-benar menjalankan query. Untuk query baca, ini umumnya aman, tetapi perhatikan efek samping jika menguji perintah yang mengubah data. Tambahkan BUFFERS untuk melihat aktivitas blok, dan gunakan parameter yang sama pada kedua pengujian.
EXPLAIN (ANALYZE, BUFFERS, FORMAT TEXT)
SELECT id, created_at, title
FROM posts
WHERE tenant_id = 42
ORDER BY created_at DESC, id DESC
LIMIT 50 OFFSET 5000;
Pagination dengan OFFSET realistis, tetapi baris yang dilewati tetap perlu ditemukan sebelum hasil halaman dikembalikan. Karena itu, biayanya dapat meningkat pada offset besar. Jika kebutuhan produk memungkinkan, bandingkan juga pendekatan pagination berbasis cursor secara terpisah; jangan mencampur perubahan query dengan pengujian dampak indeks.
Tambahkan indeks yang sesuai dengan query
Query memfilter berdasarkan tenant_id dan mengurutkan berdasarkan created_at serta id. Indeks gabungan berikut dapat membantu PostgreSQL menemukan baris tenant dalam urutan yang dibutuhkan:
CREATE INDEX posts_tenant_created_id_idx
ON posts (tenant_id, created_at DESC, id DESC);
ANALYZE posts;
Jalankan ulang query yang sama setelah indeks dibuat. ANALYZE memperbarui statistik yang digunakan perencana query; lakukan dengan kondisi data yang setara. Catat hasil sebelum dan sesudah, termasuk teks rencana lengkap, bukan hanya satu angka waktu.
Indeks tidak selalu memperbaiki query. PostgreSQL dapat memilih sequential scan jika sebagian besar tabel perlu dibaca, tabel kecil, statistik menunjukkan pilihan itu lebih murah, atau indeks tidak cocok dengan filter dan urutan. Indeks juga menambah ruang penyimpanan dan biaya saat data ditulis.
Baca metrik EXPLAIN ANALYZE
- Actual time: waktu aktual pada node rencana, dalam milidetik. Nilai awal dan akhir menunjukkan waktu mulai serta waktu selesai node. Pada node yang berjalan berulang, waktu dan jumlah baris aktual dilaporkan per loop; perhatikan juga
loops. Jangan menjumlahkan waktu semua node karena waktu node dapat mencakup pekerjaan anak. - Rows: bandingkan
rowsaktual dengan estimasirowspada setiap node. Selisih besar dapat menandakan estimasi kardinalitas yang kurang tepat. Jumlah baris pada node berbeda tidak selalu sama dengan jumlah hasil akhir. - Scan type:
Seq Scanmembaca tabel secara berurutan;Index Scanmenelusuri indeks lalu mengambil baris tabel;Index Only Scanberpotensi memenuhi kebutuhan dari indeks, bergantung pada visibilitas baris. Jenis scan bukan ukuran performa tunggal. - Buffers: jumlah blok yang dibaca dari cache PostgreSQL atau storage dapat membantu menjelaskan perubahan kerja I/O. Bedakan blok hit dan read saat membandingkan.
Fokus pada perubahan rencana dan biaya kerja, bukan sekadar apakah hasil memuat kata Index Scan. Rencana dengan indeks masih bisa lambat jika harus mengambil banyak baris, sedangkan sequential scan dapat menjadi pilihan yang tepat.
Buat laporan HTML statis
Salin ringkasan dari dua hasil pengujian ke tabel berikut. Angka di bawah bersifat ilustrasi, bukan hasil benchmark; ganti dengan hasil pengukuran Anda. Simpan sebagai explain-report.html dan buka di browser. Struktur HTML tetap dapat dibaca tanpa JavaScript atau pustaka tambahan.
<!doctype html>
<html lang="id">
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>Perbandingan EXPLAIN ANALYZE</title>
<style>
body { max-width: 60rem; margin: 2rem auto; padding: 0 1rem;
font: 1rem/1.5 system-ui, sans-serif; color: #202124; }
table { width: 100%; border-collapse: collapse; }
th, td { padding: .65rem; border: 1px solid #bbb; text-align: left; }
caption { text-align: left; font-weight: 700; margin-bottom: .5rem; }
code { overflow-wrap: anywhere; }
</style>
<main>
<h1>Perbandingan EXPLAIN ANALYZE</h1>
<p>Query: posts per tenant, urut terbaru, LIMIT 50 OFFSET 5000.</p>
<table>
<caption>Ringkasan hasil; ganti nilai ilustrasi dengan hasil aktual.</caption>
<thead>
<tr><th scope="col">Metrik</th>
<th scope="col">Sebelum indeks</th>
<th scope="col">Sesudah indeks</th></tr>
</thead>
<tbody>
<tr><th scope="row">Execution time</th>
<td>[catat] ms</td><td>[catat] ms</td></tr>
<tr><th scope="row">Scan utama</th>
<td>[mis. Seq Scan]</td><td>[mis. Index Scan]</td></tr>
<tr><th scope="row">Rows aktual</th>
<td>[catat per node]</td><td>[catat per node]</td></tr>
<tr><th scope="row">Buffers</th>
<td>[catat hit/read]</td><td>[catat hit/read]</td></tr>
</tbody>
</table>
<h2>Catatan</h2>
<p>Dataset, parameter, dan kondisi pengujian: [isi].
Rencana lengkap: [tautkan atau lampirkan berkas teks].</p>
</main>
</html>
Gunakan label yang menjelaskan konteks, sertakan parameter dan kondisi pengujian, lalu simpan rencana lengkap sebagai teks atau lampiran. Tabel ringkasan memudahkan pemindaian cepat; rencana lengkap tetap diperlukan untuk menelusuri node yang mahal dan estimasi baris.
Hindari kesimpulan yang menyesatkan
- Jangan menyimpulkan dampak indeks dari satu pengukuran. Catat beberapa pengulangan dengan prosedur yang sama dan bandingkan hasilnya secara konsisten.
- Jangan mengubah query, parameter, data, dan indeks sekaligus. Perubahan berganda menyulitkan penentuan penyebab perbedaan.
- Jangan menganggap waktu total sebagai satu-satunya metrik. Periksa node dominan, baris aktual, estimasi, dan buffers.
- Jangan menyamakan rencana yang berbeda dengan masalah. Perencana memilih rencana berdasarkan estimasi biaya; verifikasi dengan hasil aktual dan beban yang relevan.
Laporan yang berguna bukan yang paling rumit, melainkan yang membuat kondisi pengujian dan perubahan rencana dapat diverifikasi. HTML semantik sederhana sudah cukup untuk mencatat perbandingan; tambahkan otomasi hanya jika pengujian rutin memang membutuhkannya.
Komentar
0 komentar
Masuk ke akun kamu untuk ikut berkomentar.
Belum ada komentar
Jadilah yang pertama ikut berdiskusi!