全部产品

PolarDB：Parameter

更新时间：Jan 07, 2026

Topik ini menjelaskan parameter dan tipe data untuk indeks penyimpanan kolom.

Parameter konfigurasi

Parameter	Nilai valid	Nilai default	Deskripsi
polar_csi.enable_query	on\|off	off	Menentukan apakah pernyataan kueri dapat menggunakan indeks penyimpanan kolom. Nilai yang valid: off (default): Pernyataan kueri tidak dapat menggunakan indeks penyimpanan kolom. on: Pernyataan kueri dapat menggunakan indeks penyimpanan kolom.
polar_csi.cost_threshold	1 hingga 1000000000	50000	Jika biaya kueri lebih kecil dari ambang batas ini, pernyataan kueri tidak menggunakan indeks penyimpanan kolom untuk akselerasi. Sesuaikan nilai berdasarkan workload bisnis aktual Anda. Jika nilai ini terlalu tinggi, pernyataan SQL yang memakan waktu tidak dapat menggunakan indeks penyimpanan kolom, sehingga memperlambat kueri. Jika nilai ini terlalu rendah, pernyataan SQL simple menggunakan indeks penyimpanan kolom, sehingga mengurangi konkurensi sistem. Catatan Gunakan `EXPLAIN` atau `EXPLAIN ANALYZE` untuk mengkueri dan menganalisis biaya suatu pernyataan SQL. PostgreSQL 14: Nilai default diubah menjadi 50000 mulai versi mesin minor 2.0.14.13.28.0 dan seterusnya. Nilai default sebelumnya adalah 1000. PostgreSQL 16: Nilai default diubah menjadi 50000 mulai versi mesin minor 2.0.16.10.12.0 dan seterusnya. Nilai default sebelumnya adalah 1000.
polar_csi.exec_parallel	1 hingga 512	2	Tingkat paralelisme untuk indeks penyimpanan kolom. Ini adalah jumlah resource CPU yang dapat digunakan oleh satu pernyataan SQL. Secara umum, tingkat paralelisme yang lebih tinggi memberikan performa yang lebih baik. Nilai aktual bergantung pada spesifikasi resource kluster. Sesuaikan parameter ini berdasarkan spesifikasi kluster Anda. Nilainya tidak boleh melebihi jumlah core CPU pada node komputasi.
polar_csi.memory_limit	1 hingga 1048576	4096	Jumlah memori yang dapat digunakan oleh indeks penyimpanan kolom. Satuan: MB. Ambang batas memori yang lebih besar menghasilkan pembuatan indeks yang lebih cepat. Sesuaikan parameter ini berdasarkan spesifikasi kluster Anda. Nilainya tidak boleh melebihi 25% dari memori kluster. Jika dilanggar, error kehabisan memori (OOM) dapat terjadi. Catatan PostgreSQL 14: Nilai default diubah menjadi 4096 mulai versi mesin minor 2.0.14.19.40.0 dan seterusnya. Nilai default sebelumnya adalah 1024. PostgreSQL 16: Nilai default diubah menjadi 4096 mulai versi mesin minor 2.0.16.10.12.0 dan seterusnya. Nilai default sebelumnya adalah 1024.
polar_csi.flush_count	2048 hingga 20480000	204.800	Jumlah baris yang dikomit dalam satu batch saat Anda membuat indeks. Menambah jumlah baris dapat meningkatkan efisiensi pembuatan, tetapi juga mengonsumsi lebih banyak memori.
polar_csi.update_interval	0 hingga 3600	1	Interval pembaruan berkala untuk data baris dan kolom real-time. Satuan: detik. Menambah interval pembaruan memungkinkan penggabungan transaksi kecil dengan tipe yang sama. Hal ini meningkatkan efisiensi pembaruan data ketika terdapat banyak transaksi. Catatan PostgreSQL 14: Parameter ini ditambahkan mulai versi mesin minor 2.0.14.13.28.0 dan seterusnya untuk meningkatkan performa real-time indeks penyimpanan kolom. PostgreSQL 16: Parameter ini ditambahkan mulai versi mesin minor 2.0.16.10.12.0 dan seterusnya untuk meningkatkan performa real-time indeks penyimpanan kolom.
polar_csi.update_batch_count	1024 hingga 4294967295	100.000	Ambang batas jumlah baris dalam pembaruan batch. Jumlah maksimum baris dalam transaksi pembaruan. Meningkatkan ambang batas ini dapat meningkatkan efisiensi pembaruan data. Catatan PostgreSQL 14: Parameter ini ditambahkan mulai versi mesin minor 2.0.14.13.28.0 dan seterusnya untuk meningkatkan performa real-time indeks penyimpanan kolom. PostgreSQL 16: Parameter ini ditambahkan mulai versi mesin minor 2.0.16.10.12.0 dan seterusnya untuk meningkatkan performa real-time indeks penyimpanan kolom.
polar_csi.forward_replay_wait	on\|off	off	Tingkat konsistensi kueri untuk data indeks penyimpanan kolom. Nilai yang valid: off: Konsistensi eventual. Data dalam indeks penyimpanan kolom mungkin tertinggal dari data dalam penyimpanan baris. on: Konsistensi kuat. Kueri menunggu data penyimpanan kolom direplay ke versi terbaru sebelum dieksekusi. Jika tekanan penulisan tinggi, mengaktifkan parameter ini dapat menyebabkan waktu tunggu yang lama.
polar_csi.forward_replay_wait_lsn_diff	0 hingga INT_MAX	0	Latensi sinkronisasi yang diizinkan dalam ukuran LSN antara penyimpanan baris dan penyimpanan kolom. Jika latensi melebihi ambang batas ini, mesin penyimpanan kolom tidak lagi digunakan. Satuan: BYTE. Catatan Parameter ini hanya berlaku ketika `polar_csi.forward_replay_wait` diaktifkan. Parameter ini hanya berlaku untuk versi berikut: PostgreSQL 14: Versi mesin minor 2.0.14.19.40.0 dan seterusnya. PostgreSQL 16: Versi mesin minor 2.0.16.10.12.0 dan seterusnya. PostgreSQL 15 dan PostgreSQL 17: Sama seperti cakupan penerapan.
polar_csi.sync_addcolumn	on\|off	off	Menentukan apakah operasi Add Column disinkronkan ke indeks penyimpanan kolom. Catatan Parameter ini hanya berlaku untuk versi berikut: PostgreSQL 14: Versi mesin minor 2.0.14.19.40.0 dan seterusnya. PostgreSQL 16: Versi mesin minor 2.0.16.10.12.0 dan seterusnya. PostgreSQL 15 dan PostgreSQL 17: Sama seperti cakupan penerapan.

Tipe data

Kategori	Tipe data
Tipe data dasar	`BOOLEAN`, `ARRAY`, `BIT`, `UUID`
Tipe string dan biner	`BPCHAR`, `CHAR`, `VARCHAR`, `TEXT`, `NAME`, `BYTEA`
Tipe tanggal dan waktu	`DATE`, `TIME`, `TIMESTAMP`, `TIMESTAMPTZ`, `INTERVAL`
Tipe numerik	`BIGINT`, `DECIMAL`, `DOUBLE PRECISION`, `FLOAT4`, `FLOAT8`, `INTEGER`, `NUMERIC`, `REAL`, `SERIAL`, `SHORT`, `SMALLINT`
Tipe komposit	`JSON`, `JSONB`, `ENUM`, `BITSTRING`, `VARCHAR[]`, `TEXT[]` Catatan PostgreSQL 14: Tipe data `BITSTRING`, `VARCHAR[]`, dan `TEXT[]` ditambahkan mulai versi mesin minor 2.0.14.19.40.0 dan seterusnya. PostgreSQL 16: Tipe data `BITSTRING`, `VARCHAR[]`, dan `TEXT[]` ditambahkan mulai versi mesin minor 2.0.16.10.12.0 dan seterusnya.