PolarDB:Aktifkan dan gunakan indeks penyimpanan kolom

Pilih metode pengaktifan

Metode yang tersedia bergantung pada versi mesin minor Anda.

Untuk PostgreSQL 16 (2.0.16.9.8.0 atau lebih baru) atau PostgreSQL 14 (2.0.14.17.35.0 atau lebih baru)

Tersedia dua metode. Pilih berdasarkan kebutuhan isolasi workload dan biaya Anda:

Untuk PostgreSQL 16 (2.0.16.8.3.0 hingga 2.0.16.9.8.0) atau PostgreSQL 14 (2.0.14.10.20.0 hingga 2.0.14.17.35.0)

Hanya tersedia satu metode: instal ekstensi polar_csi secara manual. Lihat Instal ekstensi polar_csi.

Tambahkan node read-only IMCI

Anda dapat menambahkan node read-only IMCI saat membeli kluster atau setelah kluster berjalan.

Kluster harus memiliki setidaknya satu node read-only sebelum Anda dapat menambahkan node IMCI. Kluster single-node tidak didukung.

Tambahkan saat pembelian

Di halaman pembelian PolarDB, atur jumlah node untuk parameter IMCI Read-Only Nodes.

Tambahkan di Konsol

1. Login ke Konsol PolarDB dan buka wilayah tempat kluster Anda berada. Buka wizard Add/Remove Node dengan salah satu metode berikut:

   • Di halaman Clusters, klik Add/Remove Node di kolom Actions.

   • Di halaman Basic Information kluster Anda, klik Add/Remove Node di bagian Database Nodes.

2. Pilih Add Read-only IMCI Node dan klik OK.

3. Di halaman upgrade/downgrade, konfigurasi dan beli node:

   1. Klik Add an IMCI Node dan pilih spesifikasi node.

   2. Pilih waktu switchover.

   3. (Opsional) Tinjau Ketentuan Layanan Produk dan Service Level Agreement.

   4. Klik Buy Now.

4. Kembali ke halaman detail kluster dan tunggu hingga status node berubah menjadi Running.

   

Instal ekstensi polar_csi

Akun database yang digunakan untuk menginstal ekstensi harus merupakan Akun istimewa.

Ekstensi polar_csi bersifat cakupan tingkat database. Untuk menggunakan CSI di beberapa database dalam satu kluster, instal ekstensi tersebut di setiap database secara terpisah.

Gunakan metode ini untuk kluster yang menjalankan PostgreSQL 16 (2.0.16.8.3.0 hingga 2.0.16.9.8.0) atau PostgreSQL 14 (2.0.14.10.20.0 hingga 2.0.14.17.35.0). Untuk versi yang lebih baru, ekstensi sudah pra-instal.

CREATE EXTENSION polar_csi;

Sintaks

Gunakan klausa USING CSI untuk membuat indeks penyimpanan kolom. Sertakan CONCURRENTLY untuk menghindari pemblokiran operasi tulis selama pembuatan indeks.

-- Indeks kolom tertentu
CREATE INDEX [ CONCURRENTLY ] <index_name> ON <table_name> USING CSI(<column1>, <column2>, ...);

-- Indeks semua kolom
CREATE INDEX [ CONCURRENTLY ] <index_name> ON <table_name> USING CSI;

Parameter

CONCURRENTLY memerlukan PostgreSQL 14 dengan versi mesin minor 2.0.14.13.27.0 atau lebih baru. Versi ini juga mengaktifkan fitur logical replication slot secara default. Pada versi lama, instal ulang ekstensi polar_csi atau hubungi dukungan. Selama pembuatan indeks secara konkuren, sebuah logical replication slot sementara dibuat dan dilepas secara otomatis setelah sinkronisasi data selesai.

Contoh

1. Buat tabel uji dengan primary key:

   CREATE TABLE sales (sale_id int primary key, name CHAR(10), amount int);

2. Buat indeks penyimpanan kolom. Pilih salah satu opsi berikut:

   Tujuan	Pernyataan
   Indeks kolom tertentu	CREATE INDEX idx_csi_sales ON sales USING CSI(sale_id, amount);
   Indeks semua kolom	CREATE INDEX idx_csi_sales ON sales USING CSI;
   Indeks kolom tertentu tanpa memblokir tulis	CREATE INDEX CONCURRENTLY idx_csi_sales ON sales USING CSI(sale_id, amount);

3. Verifikasi bahwa indeks telah dibuat:

   SELECT * FROM pg_indexes WHERE tablename = 'sales';

Monitor progres pembuatan indeks

Untuk tabel besar, pembuatan indeks dapat memakan waktu cukup lama. Periksa progres dengan:

SELECT * FROM pg_stat_progress_create_index;

Kolom utama yang perlu diperhatikan:

Ketika blocks_done sama dengan blocks_total dan tuples_done sama dengan tuples_total, indeks telah selesai.

Batalkan pembuatan indeks

Jika pembuatan indeks memakan waktu terlalu lama dan memengaruhi workload Anda, batalkan menggunakan process ID (pid) dari pg_stat_progress_create_index:

-- Batalkan secara graceful
SELECT pg_cancel_backend(<pid>);

-- Hentikan paksa
SELECT pg_terminate_backend(<pid>);

Periksa ukuran indeks

SELECT pg_size_pretty(pg_relation_size('idx_csi_sales'));

Konfigurasi sinkronisasi data real-time

Setelah Anda membuat indeks penyimpanan kolom, data baru yang ditulis ke tabel row-store secara otomatis disinkronkan ke indeks secara real-time. Tidak diperlukan konfigurasi tambahan.

Untuk menyesuaikan performa sinkronisasi dalam skenario tulis intensif (PostgreSQL 14, versi mesin minor 2.0.14.13.28.0 atau lebih baru), sesuaikan:

Parameter ini hanya tersedia pada PostgreSQL 14 (versi mesin minor 2.0.14.13.28.0 atau lebih baru). PostgreSQL 16 tidak memiliki parameter setara.

Aktifkan routing kueri

Secara default, kueri tidak menggunakan indeks penyimpanan kolom. Aktifkan pada cakupan yang sesuai dengan kasus penggunaan Anda:

SET polar_csi.enable_query = ON;

CREATE EXTENSION pg_hint_plan;

-- Arahkan satu kueri ke indeks penyimpanan kolom
/*+ SET(polar_csi.enable_query on) */ SELECT COUNT(*) FROM sales;

-- Arahkan satu kueri dan atur threshold biaya
/*+ SET(polar_csi.enable_query on) SET(polar_csi.cost_threshold 0) */ SELECT COUNT(*) FROM sales;

Kontrol threshold biaya

Parameter polar_csi.cost_threshold menentukan kapan mesin penyimpanan kolom digunakan. Jika estimasi biaya kueri berada di bawah ambang batas, mesin row-store menangani kueri; jika di atas, mesin penyimpanan kolom yang menangani.

SET polar_csi.cost_threshold = 0;

Mengatur polar_csi.cost_threshold ke 0 memaksa semua kueri menggunakan indeks penyimpanan kolom, termasuk pencarian sederhana yang mungkin lebih cepat di row store. Hindari pengaturan ini di lingkungan produksi. Sesuaikan ambang batas berdasarkan workload aktual Anda.

Verifikasi bahwa kueri menggunakan indeks penyimpanan kolom

Gunakan EXPLAIN untuk memeriksa Rencana kueri. Kueri yang menggunakan indeks penyimpanan kolom akan menampilkan CSI Executor dalam output rencana:

SHOW polar_csi.cost_threshold;
EXPLAIN SELECT COUNT(*) FROM sales;

Output yang diharapkan:

  QUERY PLAN
--------------
 CSI Executor
(1 row)

Jika Anda tidak melihat CSI Executor, lihat Pemecahan Masalah.

Konfigurasi konsistensi kueri

Indeks penyimpanan kolom mendukung dua Tingkat konsistensi:

-- Aktifkan konsistensi kuat
SET polar_csi.forward_replay_wait = on;

Di bawah tekanan tulis tinggi, konsistensi kuat dapat menyebabkan kueri menunggu lebih lama. Aktifkan hanya jika kasus penggunaan Anda memerlukannya.

Percepat pembuatan indeks

Percepat kueri

Untuk PostgreSQL 14, nilai default polar_csi.cost_threshold diubah menjadi 50.000 pada versi mesin minor 2.0.14.13.28.0. Versi sebelumnya menggunakan nilai default 1.000.

Kueri tidak menggunakan indeks penyimpanan kolom

Jika EXPLAIN tidak menampilkan CSI Executor, lakukan pemeriksaan berikut secara berurutan:

1. Konfirmasi `polar_csi.enable_query` aktif.

   SHOW polar_csi.enable_query;

   Jika output adalah off, aktifkan:

   SET polar_csi.enable_query = ON;

2. Periksa threshold biaya.

   SHOW polar_csi.cost_threshold;
   EXPLAIN SELECT COUNT(*) FROM sales;

   Bandingkan estimasi biaya kueri (dari output EXPLAIN) dengan ambang batas. Jika biaya lebih rendah dari ambang batas, mesin row-store menangani kueri sesuai desain. Turunkan ambang batas atau gunakan petunjuk per-kueri untuk memaksa routing ke penyimpanan kolom saat pengujian.

3. Verifikasi bahwa indeks penyimpanan kolom mencakup kolom yang dikueri.

   SELECT * FROM pg_indexes WHERE tablename = 'sales';

   Jika indeks tidak mencakup kolom yang dirujuk dalam kueri, hapus dan buat ulang dengan kolom yang benar.

4. Periksa fitur yang tidak didukung. Tinjau batasan untuk memastikan bahwa kueri dan konfigurasi tabel memenuhi semua persyaratan.