EXPLAIN query menampilkan rencana yang dipilih PostgreSQL untuk sebuah query: pohon langkah (node) dengan perkiraan cost dan jumlah baris. EXPLAIN ANALYZE query juga menjalankan query-nya dan menambahkan waktu, baris, dan loop sebenarnya di setiap node. Baca pohonnya dari node yang paling menjorok ke dalam ke arah luar: node di dalam mengalirkan barisnya ke node di atasnya.
Tidak ada index pada email, jadi rencananya Seq Scan: PostgreSQL membaca setiap baris dan menyimpan yang lolos Filter. Rows Removed by Filter menunjukkan pekerjaan yang terbuang. Waktunya berbeda di setiap eksekusi; bentuk rencananya lebih penting daripada angkanya.
Membaca satu baris rencana
Setiap node mencetak satu baris dengan bentuk seperti ini:
Seq Scan on users (cost=STARTUP..TOTAL rows=N width=W) (actual time=FIRST..LAST rows=N loops=L)
| Bagian | Arti |
|---|---|
cost=STARTUP..TOTAL | perkiraan pekerjaan sebelum baris pertama, dan untuk semua baris, dalam satuan planner (bukan milidetik) |
rows (pertama) | perkiraan jumlah baris yang dikembalikan node |
width | perkiraan rata-rata ukuran baris dalam byte |
actual time | milidetik sampai baris pertama dan sampai baris terakhir, per loop |
rows (aktual) | baris yang dikembalikan, per loop |
loops | berapa kali node berjalan; kalikan waktu dan baris dengan angka ini |
Cost sebuah induk sudah termasuk anak-anaknya. Planning Time dan Execution Time di bagian bawah adalah total untuk seluruh pernyataan.
Mengenali node rencana yang umum
EXPLAIN (COSTS OFF) menyembunyikan angka, jadi bentuk rencananya lebih mudah dilihat:
Baca dari dalam. Kedua tabel dipindai dan pelanggan yang sudah difilter masuk ke Hash. Hash Join mencocokkannya dengan setiap pesanan, dan GroupAggregate di atasnya menghitung hasilnya. Node yang paling sering kamu temui:
| Node | Fungsinya |
|---|---|
Seq Scan | membaca seluruh tabel |
Index Scan | menemukan baris lewat index, lalu membaca setiap baris dari tabel |
Index Only Scan | menjawab dari index tanpa mengunjungi tabel |
Bitmap Index Scan + Bitmap Heap Scan | mengumpulkan lokasi baris yang cocok dari index, lalu membacanya sesuai urutan tabel |
Nested Loop | untuk setiap baris luar, mencari pasangannya di input dalam; bagus saat sisi luarnya kecil |
Hash Join + Hash | membangun hash table dari satu input, lalu mencocokkannya dengan input lain |
Merge Join | menggabungkan dua input yang sudah terurut berdasarkan kunci join |
Sort, Incremental Sort | mengurutkan baris untuk ORDER BY, DISTINCT, atau merge join |
HashAggregate, GroupAggregate | GROUP BY dengan hash table, atau pada input yang terurut |
Limit | berhenti setelah N baris |
Gather | mengumpulkan baris dari worker paralel |
Menemukan perkiraan baris yang meleset
Pemeriksaan paling berguna di EXPLAIN ANALYZE adalah membandingkan rows perkiraan dengan rows aktual di node yang sama. Saat keduanya jauh berbeda, planner memilih rencananya dari angka yang salah, sering kali karena statistiknya tidak ada atau sudah usang:
Scan-nya mengembalikan 10 baris aktual, tapi perkiraannya jauh lebih tinggi karena tabelnya belum dianalisis. Tambahkan ANALYZE tasks; sebelum EXPLAIN dan perkiraannya mendekati 10. Autovacuum menganalisis tabel di latar belakang, tapi jalankan ANALYZE sendiri setelah bulk load (lihat VACUUM dan autovacuum).
EXPLAIN untuk perubahan data tanpa menyimpannya
EXPLAIN ANALYZE menjalankan pernyataannya, jadi UPDATE atau DELETE benar-benar mengubah baris. Bungkus dalam transaksi lalu rollback:
Seluruh 1000 baris masih ada setelah rollback.
Menampilkan I/O dengan BUFFERS dan opsi lainnya
EXPLAIN (ANALYZE, BUFFERS) SELECT ...; -- pages read from cache (hit) and disk (read)
EXPLAIN (ANALYZE, BUFFERS, SETTINGS) SELECT ...; -- also list changed planner settings
EXPLAIN (FORMAT JSON) SELECT ...; -- machine-readable, for plan visualizers
EXPLAIN (ANALYZE, TIMING OFF) SELECT ...; -- row counts without per-node timing overhead
BUFFERS menampilkan I/O: node dengan banyak page read mengambil data dari disk. PostgreSQL 17 menambahkan SERIALIZE (biaya mengubah baris output menjadi teks) dan MEMORY (memori planner). Panduan resmi EXPLAIN membahas lebih banyak rencana.
Menguji rencana dengan pengaturan planner
Untuk melihat rencana yang akan dipakai PostgreSQL tanpa sebuah metode, matikan metode itu untuk sesimu. Lakukan ini hanya untuk eksperimen, jangan pernah di kode produksi:
Dengan 100 baris, planner lebih memilih Seq Scan; dengan enable_seqscan = off, rencananya menampilkan Index Scan using items_pkey. Bandingkan waktu dari kedua EXPLAIN ANALYZE untuk melihat apakah index membantu. RESET enable_seqscan; mengembalikan default-nya.
Pertanyaan yang sering diajukan
Apa perbedaan EXPLAIN dan EXPLAIN ANALYZE?
EXPLAIN hanya merencanakan query dan menampilkan perkiraan. EXPLAIN ANALYZE juga menjalankannya dan menambahkan waktu, jumlah baris, dan jumlah loop sebenarnya di setiap node, jadi lamanya sama dengan query itu sendiri.
Apa arti cost dalam rencana PostgreSQL?
Cost adalah perkiraan planner dalam satuan bebas, diskalakan sehingga membaca satu page secara berurutan bernilai 1 (seq_page_cost). Angka ini berguna untuk membandingkan rencana dari query yang sama, bukan sebagai waktu dalam milidetik.
Apakah EXPLAIN ANALYZE mengubah data?
Ya, untuk INSERT, UPDATE, DELETE, dan MERGE, perintah ini benar-benar melakukan perubahannya. Jalankan di antara BEGIN dan ROLLBACK untuk mengukur tanpa menyimpan hasilnya.
Kenapa Seq Scan yang dipilih padahal ada index?
Karena planner memperkirakan cara itu lebih murah: tabelnya kecil, query mengembalikan sebagian besar baris, atau kondisinya tidak bisa memakai index. Statistik yang usang juga bisa menyesatkan planner, yang bisa diperbaiki dengan ANALYZE.