Query notifikasi tim dapat melambat ketika tabel menyimpan banyak riwayat dan halaman yang diminta berada jauh di belakang. Untuk mengukurnya dan memperbaikinya, periksa rencana eksekusi dengan EXPLAIN (ANALYZE, BUFFERS), buat index yang mengikuti filter serta urutan query, lalu ganti OFFSET dengan keyset pagination.
Konteks koordinasi tim dan gangguan rapat yang dibahas dalam laporan Wired tentang rapat karyawan Meta mengingatkan bahwa akses cepat ke pembaruan tim dapat relevan dalam alur kerja yang padat. Artikel ini berfokus pada sisi teknis: membaca dan menguji query notifikasi, bukan mengukur dampak produktivitas atau membuat klaim tentang laporan tersebut.
1. Tetapkan skema dan query dasar
Contoh berikut memakai PostgreSQL, satu baris untuk setiap notifikasi, serta waktu pembuatan yang tidak boleh bernilai NULL. Kolom id menjadi pemecah seri ketika beberapa notifikasi memiliki waktu yang sama.
CREATE TABLE notifications (
id bigint GENERATED ALWAYS AS IDENTITY PRIMARY KEY,
team_id bigint NOT NULL,
created_at timestamptz NOT NULL DEFAULT now(),
message text NOT NULL
);
SELECT id, created_at, message
FROM notifications
WHERE team_id = $1
ORDER BY created_at DESC, id DESC
LIMIT 50 OFFSET 5000;Query ini mengambil halaman setelah melewati 5.000 baris untuk satu tim. Dengan OFFSET, database tetap perlu menemukan dan melewati baris yang mendahului hasil halaman. Biayanya dapat bertambah seiring makin dalam posisi halaman; index tidak menghilangkan pekerjaan melewati baris tersebut.
2. Baca EXPLAIN (ANALYZE, BUFFERS)
Jalankan rencana untuk query yang mewakili beban nyata, termasuk nilai team_id dan offset yang realistis. ANALYZE menjalankan query, jadi gunakan kehati-hatian pada query mahal atau lingkungan produksi. BUFFERS menampilkan aktivitas buffer PostgreSQL, bukan ukuran data yang dibaca dari penyimpanan eksternal secara langsung.
EXPLAIN (ANALYZE, BUFFERS)
SELECT id, created_at, message
FROM notifications
WHERE team_id = 42
ORDER BY created_at DESC, id DESC
LIMIT 50 OFFSET 5000;Periksa bagian berikut dalam hasilnya:
- Scan dan sort:
Seq Scandapat berarti banyak baris diperiksa.Sortmenunjukkan baris perlu diurutkan; lihat apakah index yang sesuai dapat menyajikan urutan yang diminta. - Rows dan loops: bandingkan jumlah baris aktual dengan perkiraan dan periksa berapa kali node dijalankan. Perbedaan besar antara perkiraan dan aktual dapat mengarahkan penyelidikan ke statistik atau distribusi data.
- Execution Time: waktu aktual query untuk eksekusi tersebut. Hasil satu kali bukan benchmark yang mewakili semua pola beban.
- Buffers: periksa
shared hitdanshared readpada node. Hit berarti blok ditemukan di shared buffer; read berarti blok dimuat ke shared buffer. Keduanya membantu menunjukkan banyaknya aktivitas buffer, tetapi read tidak selalu berarti pembacaan fisik dari perangkat karena cache sistem operasi dapat terlibat.
Bandingkan node dan nilai aktual sebelum serta sesudah perubahan. Jangan menyimpulkan bahwa query membaik hanya karena rencananya berubah menjadi Index Scan; periksa juga waktu, baris yang diperiksa, dan buffer. Pengukuran berulang dengan kondisi cache dan beban yang sebanding lebih berguna daripada satu angka.
3. Rancang composite index sesuai filter dan urutan
Query memfilter dengan kesetaraan pada team_id, lalu mengurutkan berdasarkan created_at DESC, id DESC. Buat index dengan kolom filter di depan dan kolom urutan setelahnya:
CREATE INDEX notifications_team_created_id_idx
ON notifications (team_id, created_at DESC, id DESC);Urutan kolom ini memungkinkan PostgreSQL mencari rentang untuk satu tim dan membaca entri sesuai urutan notifikasi. Karena kedua kolom urutan dicantumkan, urutan hasil tetap deterministik saat beberapa baris memiliki created_at yang sama. Sebagai alternatif, PostgreSQL dapat membaca index B-tree dalam arah terbalik untuk urutan yang sepenuhnya berlawanan; definisi di atas secara langsung mencerminkan query contoh.
Index ini tidak mencakup kolom message. PostgreSQL mungkin perlu mengambil baris dari tabel untuk mengembalikan kolom tersebut. Menambahkan kolom besar seperti pesan ke index dapat meningkatkan ukuran dan biaya penulisan. Pertimbangkan index yang mencakup kolom tambahan hanya setelah mengukur kebutuhan; index-only scan juga bergantung pada kondisi visibility map, bukan sekadar keberadaan kolom di index.
Index memakai ruang penyimpanan dan menambah pekerjaan pada operasi tulis serta pemeliharaan. Tabel dengan banyak tim kecil dan distribusi anggota yang tidak merata dapat menunjukkan biaya berbeda. Periksa pola nyata, statistik tabel, dan query lain yang memakai index sebelum mempertahankan perubahan.
4. Ganti OFFSET dengan keyset pagination
Keyset pagination memakai nilai baris terakhir dari halaman sebelumnya sebagai batas halaman berikutnya. Untuk urutan menurun pada kedua kolom, gunakan perbandingan tuple yang sama arahnya:
SELECT id, created_at, message
FROM notifications
WHERE team_id = $1
AND (created_at, id) < ($2, $3)
ORDER BY created_at DESC, id DESC
LIMIT 50;Parameter $2 dan $3 adalah created_at dan id dari baris terakhir halaman sebelumnya. Kondisi tuple memilih baris yang lebih lama dalam urutan menurun, sementara composite index menyediakan jalur pencarian yang sejalan dengan filter dan urutan. Ambil halaman pertama tanpa kondisi cursor; setelah menerima hasil, buat cursor dari baris terakhirnya.
Cursor sebaiknya memuat pasangan nilai yang dibutuhkan query, bukan nomor halaman. Pada API, validasi cursor dan pastikan team_id tetap berasal dari konteks otorisasi server. Jika cursor dikirim ke klien, format opak atau penandatanganan dapat mencegah manipulasi nilai cursor; cursor tidak menggantikan pemeriksaan akses. Jangan menerima team_id dari cursor sebagai otorisasi.
Batasan cursor dan konsistensi
- Keyset pagination cocok untuk navigasi berurutan, tetapi tidak menyediakan akses langsung ke halaman bernomor tertentu tanpa melakukan traversal.
- Cursor harus menggunakan semua kolom pengurutan dengan pemecah seri yang unik. Tanpa
id, timestamp yang sama dapat menyebabkan baris terlewat atau muncul berulang. - Cursor berdasarkan kolom yang berubah dapat menghasilkan perilaku membingungkan jika baris diperbarui di antara permintaan. Gunakan kolom urutan yang stabil bila memungkinkan.
- Keyset pagination tidak otomatis memberi snapshot konsisten lintas permintaan HTTP. Baris baru dapat muncul di antara halaman; kebutuhan konsistensi lebih kuat memerlukan strategi transaksi atau batas snapshot yang dirancang khusus.
5. Bandingkan perubahan dengan pengukuran
Uji query sebelum dan sesudah index, lalu bandingkan versi OFFSET dan keyset pada tim serta kedalaman halaman yang sama. Catat parameter, ukuran hasil, Execution Time, baris aktual, node scan, dan nilai Buffers. Jalankan pengukuran berulang dengan kondisi yang terdokumentasi; jangan membandingkan satu eksekusi hangat dengan satu eksekusi dingin seolah-olah setara.
Periksa juga biaya perubahan index: waktu pembuatan, ukuran index, serta dampaknya pada tulis dan query lain. Ukur pada data yang mewakili distribusi produksi, termasuk tim dengan riwayat kecil maupun besar. Jangan mengarang angka atau menganggap perubahan berhasil hanya karena query sintaksnya valid.
Kesimpulan
Mulai dari rencana eksekusi dan pola query yang benar-benar dipakai. Composite index (team_id, created_at DESC, id DESC) menyelaraskan pencarian tim dengan urutan notifikasi, sedangkan keyset pagination menghindari pekerjaan melewati offset halaman dalam. Validasi hasil melalui pengukuran waktu, baris, buffer, ukuran index, dan perilaku data baru; pilih pendekatan berdasarkan kebutuhan navigasi serta konsistensi aplikasi.
Komentar
0 komentar
Masuk ke akun kamu untuk ikut berkomentar.
Belum ada komentar
Jadilah yang pertama ikut berdiskusi!