Menu

EXPLAIN ANALYZE PostgreSQL: Cara Membaca Query Plan

EXPLAIN menampilkan rencana yang dipilih PostgreSQL untuk sebuah query, dan EXPLAIN ANALYZE menjalankan query itu lalu menambahkan jumlah baris dan waktu sebenarnya di setiap langkah. Pelajari cara membaca pohon rencana dan nama node yang umum.

Halaman ini dilengkapi editor yang bisa dijalankan. Edit, jalankan, dan lihat output-nya seketika.

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)
BagianArti
cost=STARTUP..TOTALperkiraan pekerjaan sebelum baris pertama, dan untuk semua baris, dalam satuan planner (bukan milidetik)
rows (pertama)perkiraan jumlah baris yang dikembalikan node
widthperkiraan rata-rata ukuran baris dalam byte
actual timemilidetik sampai baris pertama dan sampai baris terakhir, per loop
rows (aktual)baris yang dikembalikan, per loop
loopsberapa 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:

NodeFungsinya
Seq Scanmembaca seluruh tabel
Index Scanmenemukan baris lewat index, lalu membaca setiap baris dari tabel
Index Only Scanmenjawab dari index tanpa mengunjungi tabel
Bitmap Index Scan + Bitmap Heap Scanmengumpulkan lokasi baris yang cocok dari index, lalu membacanya sesuai urutan tabel
Nested Loopuntuk setiap baris luar, mencari pasangannya di input dalam; bagus saat sisi luarnya kecil
Hash Join + Hashmembangun hash table dari satu input, lalu mencocokkannya dengan input lain
Merge Joinmenggabungkan dua input yang sudah terurut berdasarkan kunci join
Sort, Incremental Sortmengurutkan baris untuk ORDER BY, DISTINCT, atau merge join
HashAggregate, GroupAggregateGROUP BY dengan hash table, atau pada input yang terurut
Limitberhenti setelah N baris
Gathermengumpulkan 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.

Ilustrasi bahasa pemrograman di Coddy

Belajar coding dengan Coddy

Mulai