Penggantian fungsi string bergaya strncpy dapat mengubah isi nilai yang disimpan, bukan hanya cara menyalinnya. Pemotongan, terminasi NUL, padding, atau normalisasi yang berbeda dapat membuat nilai database berubah sehingga distribusi data, selektivitas indeks, query plan, dan pagination ikut terdampak.

Audit indeks database setelah perubahan fungsi string perlu memeriksa seluruh jalur penulisan dan kueri yang bergantung pada nilai tersebut. Gunakan konteks pembahasan tentang penggunaan strncpy sebagai pengingat bahwa semantik fungsi perlu diperiksa; jangan menyimpulkan perilaku aplikasi atau Linux tertentu tanpa memeriksa implementasinya.

Petakan perubahan dari kode ke data

Mulailah dengan membandingkan fungsi lama dan penggantinya pada batas input yang relevan. Fungsi dengan nama atau tujuan serupa belum tentu menghasilkan byte yang sama. Periksa panjang buffer, panjang sumber, terminasi NUL, padding, penanganan input kosong, dan aturan normalisasi seperti trim, perubahan kapitalisasi, atau konversi encoding.

  • Temukan semua jalur penulisan: API, proses latar, impor, dan pembaruan data.
  • Catat kolom database yang menerima hasil pemrosesan string.
  • Temukan indeks serta kueri yang memakai kolom itu, termasuk kondisi gabungan dan pengurutan.
  • Periksa apakah nilai lama dibaca lalu ditulis ulang dengan aturan baru.

Jika nilai dinormalisasi sebelum disimpan, pastikan aturan tersebut konsisten pada seluruh penulis dan pembaca. Menormalisasi hanya pada sebagian jalur dapat menghasilkan beberapa representasi untuk nilai yang secara bisnis dianggap sama.

Nilai perubahan terhadap selektivitas dan indeks komposit

Indeks membantu ketika kondisi kueri dapat menggunakan nilai indeks untuk mempersempit baris yang dicari. Jika perubahan menggabungkan nilai berbeda menjadi satu representasi—misalnya setelah pemotongan—jumlah baris dengan nilai yang sama dapat meningkat. Kondisi tersebut menjadi kurang selektif dan pemindaian indeks mungkin tidak lagi lebih murah daripada pemindaian tabel. Sebaliknya, normalisasi yang menyatukan variasi yang memang setara dapat membuat pencarian lebih konsisten, tetapi tetap mengubah distribusi nilai.

Indeks komposit juga bergantung pada urutan kolom dan pola kueri. Untuk indeks (tenant_id, status, created_at), kueri yang membatasi tenant_id dan status berbeda dari kueri yang hanya membatasi status. Setelah perubahan string, periksa apakah kolom yang terdampak tetap berada pada posisi yang berguna dan apakah predikat kueri masih cocok dengan indeks. Jangan menambah indeks hanya karena query plan berubah; validasi dulu predikat, distribusi data, statistik, dan kebutuhan kueri.

Gunakan skema dan kondisi yang menyerupai aplikasi. Contoh berikut bersifat generik; sesuaikan sintaks dan fitur analisis dengan mesin database yang digunakan:

CREATE INDEX idx_orders_tenant_code_created
    ON orders (tenant_id, customer_code, created_at);

SELECT id, customer_code, created_at
FROM orders
WHERE tenant_id = :tenant_id
  AND customer_code = :customer_code
ORDER BY created_at DESC, id DESC
LIMIT :page_size;

Periksa pula kecocokan tipe dan bentuk nilai parameter. Transformasi seperti fungsi pada kolom di dalam kondisi dapat membuat indeks biasa tidak dapat digunakan, bergantung pada mesin database dan indeks yang tersedia.

Bandingkan query plan sebelum dan sesudah

Ambil rencana kueri sebelum perubahan sebagai baseline, lalu ulangi kueri yang sama setelah perubahan dengan data yang representatif. Gunakan parameter, kondisi, urutan hasil, dan ukuran halaman yang sama. Jika skema atau distribusi data berubah, catat perubahan itu bersama hasil audit.

-- PostgreSQL: tampilkan rencana tanpa menjalankan kueri
EXPLAIN
SELECT id, customer_code, created_at
FROM orders
WHERE tenant_id = 42
  AND customer_code = 'A-123'
ORDER BY created_at DESC, id DESC
LIMIT 50;

Untuk mengukur baris aktual dan waktu eksekusi, PostgreSQL menyediakan EXPLAIN ANALYZE, yang menjalankan kueri. Gunakan dengan hati-hati untuk kueri yang menulis data atau memiliki efek samping. Pada mesin database lain, gunakan fasilitas rencana eksekusi yang setara; format dan detailnya tidak seragam.

Bandingkan jenis akses, indeks yang dipilih, estimasi dan jumlah baris aktual, urutan pengurutan, serta biaya atau waktu yang dilaporkan. Perbedaan estimasi dan jumlah aktual dapat menunjukkan statistik yang tidak mewakili distribusi terbaru. Jangan menganggap satu jenis plan selalu lebih baik: nilai kinerja dalam konteks volume data, konkurensi, dan pola pemakaian.

Periksa query lambat dan pagination pada tabel besar

Telusuri kueri produksi yang memfilter kolom terdampak, terutama kueri dengan banyak baris yang cocok, pengurutan, atau pagination. Bandingkan log kueri lambat atau metrik database sebelum dan sesudah perubahan. Pastikan pengujian melibatkan ukuran tabel dan distribusi data yang mendekati kondisi operasional; tabel kecil sering menyamarkan masalah selektivitas.

Pagination berbasis OFFSET dapat memerlukan pekerjaan yang meningkat saat offset makin besar, karena baris sebelumnya tetap perlu dilewati. Perubahan nilai juga dapat mengubah kelompok hasil atau urutan jika aplikasi mengandalkan kolasi dan nilai string yang berbeda. Gunakan pengurutan deterministik dengan kolom pemecah seri, seperti ID unik:

SELECT id, customer_code, created_at
FROM orders
WHERE tenant_id = :tenant_id
ORDER BY created_at DESC, id DESC
LIMIT :page_size OFFSET :offset;

Untuk halaman dalam pada tabel besar, pertimbangkan keyset pagination jika kebutuhan produk memungkinkan. Kondisi lanjutan harus memakai kolom pengurutan yang sama dan urutannya harus deterministik. Perubahan ini bukan pengganti audit kesetaraan hasil; batas halaman dan semantik urutan tetap perlu diuji.

Verifikasi hasil tanpa mengubah semantik

  1. Uji batas input. Sertakan string kosong, panjang tepat batas, lebih panjang dari buffer, karakter multibyte, serta variasi kapitalisasi atau spasi yang relevan.
  2. Bandingkan nilai tersimpan. Jalankan jalur lama dan baru pada data uji yang sama, lalu bandingkan hasil byte atau representasi yang disimpan sesuai tipe kolom.
  3. Bandingkan hasil kueri. Untuk himpunan data yang sama, bandingkan ID dan urutan hasil sebelum dan sesudah, termasuk batas antarhalaman.
  4. Uji nilai duplikat. Pastikan pemotongan atau normalisasi tidak membuat nilai yang semestinya berbeda menjadi sama, terutama jika kolom memiliki batasan unik.
  5. Ulangi analisis plan. Gunakan parameter dan data representatif yang sama. Catat perubahan indeks terpilih, jumlah baris, dan waktu; hindari kesimpulan dari satu kueri atau satu eksekusi.
  6. Pantau setelah rilis. Amati latensi kueri, tingkat penggunaan indeks, kesalahan batasan, dan pola nilai yang baru terbentuk.

Jika hasil berubah, tentukan dahulu apakah perubahan itu memang aturan bisnis yang diinginkan. Jika tidak, perbaiki kesetaraan pemrosesan atau migrasi data sebelum mengoptimalkan indeks. Jika hasil tetap sama tetapi plan memburuk, evaluasi statistik, bentuk kueri, dan indeks berdasarkan beban kerja nyata.

Audit yang aman memisahkan dua pertanyaan: apakah nilai dan hasil kueri tetap benar, lalu apakah database masih menjalankan kueri dengan biaya yang dapat diterima.