All Products
Search
Document Center

PolarDB:Parameter

Last Updated:Jul 18, 2026

Topik ini menjelaskan parameter terkait IMCI dan tipe data yang didukung.

Parameter konfigurasi

Parameter

Nilai valid

Nilai default

Deskripsi

polar_csi.enable_query

on|off

off

Menentukan apakah kueri diperbolehkan menggunakan IMCI. Nilai valid:

  • off (default): Kueri tidak diperbolehkan menggunakan IMCI.

  • on: Kueri diperbolehkan menggunakan IMCI.

polar_csi.cost_threshold

1~1000000000

50000

Jika biaya kueri lebih kecil dari ambang batas ini, pernyataan kueri tidak menggunakan IMCI untuk akselerasi. Sesuaikan nilai aktual berdasarkan workload bisnis Anda.

  • Jika nilainya terlalu besar, pernyataan SQL yang memakan waktu tidak dapat menggunakan IMCI, sehingga kueri menjadi lebih lambat.

  • Jika nilainya terlalu kecil, pernyataan SQL simple menggunakan IMCI, yang mengurangi konkurensi sistem.

Catatan
  • Anda dapat menggunakan EXPLAIN atau EXPLAIN ANALYZE untuk mengkueri dan menganalisis biaya pernyataan SQL.

  • PostgreSQL 14: Pada versi mesin minor 2.0.14.13.28.0 dan yang lebih baru, nilai default parameter ini diubah menjadi 50000. Pada versi sebelumnya, nilai default-nya adalah 1000.

  • PostgreSQL 16: Pada versi mesin minor 2.0.16.10.12.0 dan yang lebih baru, nilai default parameter ini diubah menjadi 50000. Pada versi sebelumnya, nilai default-nya adalah 1000.

polar_csi.max_parallel_workers

1~512

2

Tingkat paralelisme IMCI, yaitu sumber daya CPU yang dapat digunakan oleh satu pernyataan SQL. Secara umum, tingkat paralelisme yang lebih tinggi memberikan performa yang lebih baik.

Nilai aktual tergantung pada spesifikasi resource kluster Anda. Sesuaikan nilai berdasarkan spesifikasi kluster. Kami menyarankan agar Anda tidak mengatur nilai yang lebih besar dari jumlah core CPU pada compute node.

Catatan

Parameter polar_csi.max_parallel_workers sebelumnya bernama polar_csi.exec_parallel pada versi kernel sebelumnya. Untuk versi kernel yang tidak mendukung polar_csi.max_parallel_workers, gunakan polar_csi.exec_parallel sebagai gantinya.

  • PostgreSQL 14:

    • Gunakan polar_csi.exec_parallel pada versi 2.0.14.20.42.0 dan sebelumnya.

    • Gunakan polar_csi.max_parallel_workers pada versi 2.0.14.20.43.0 dan yang lebih baru.

  • PostgreSQL 16:

    • Gunakan polar_csi.exec_parallel pada versi 2.0.16.11.15.0 dan sebelumnya.

    • Gunakan polar_csi.max_parallel_workers pada versi 2.0.16.13.16.0 dan yang lebih baru.

polar_csi.memory_limit

1~1048576

4096

Ukuran memori yang dapat digunakan oleh IMCI. Satuan: MB.

Ambang batas memori yang lebih besar memungkinkan pembuatan indeks lebih cepat. Sesuaikan nilai berdasarkan spesifikasi kluster. Kami menyarankan agar Anda tidak mengatur nilai yang lebih besar dari 25% memori kluster. Jika tidak, error kehabisan memori (OOM) dapat terjadi.

Catatan
  • PostgreSQL 14: Pada versi mesin minor 2.0.14.19.40.0 dan yang lebih baru, nilai default parameter ini diubah menjadi 4096. Pada versi sebelumnya, nilai default-nya adalah 1024.

  • PostgreSQL 16: Pada versi mesin minor 2.0.16.10.12.0 dan yang lebih baru, nilai default parameter ini diubah menjadi 4096. Pada versi sebelumnya, nilai default-nya adalah 1024.

polar_csi.flush_count

2048~20480000

204800

Jumlah baris yang akan dikomit dalam setiap batch saat indeks dibuat.

Menambah jumlah baris dapat meningkatkan efisiensi pembuatan, tetapi juga memerlukan lebih banyak memori.

polar_csi.update_interval

0~3600

1

Interval pembaruan berkala untuk performa real-time data row-column. Satuan: detik.

Menambah interval pembaruan dapat menggabungkan transaksi kecil dengan jenis yang sama, sehingga meningkatkan efisiensi pembaruan data ketika terdapat banyak transaksi.

Catatan
  • PostgreSQL 14: Pada versi mesin minor 2.0.14.13.28.0 dan yang lebih baru, parameter ini ditambahkan untuk meningkatkan performa real-time IMCI.

  • PostgreSQL 16: Pada versi mesin minor 2.0.16.10.12.0 dan yang lebih baru, parameter ini ditambahkan untuk meningkatkan performa real-time IMCI.

polar_csi.update_batch_count

1024~4294967295

100000

Ambang batas jumlah baris yang akan diperbarui dalam satu batch.

Jumlah maksimum baris dalam satu transaksi pembaruan. Meningkatkan ambang batas ini meningkatkan efisiensi pembaruan data.

Catatan
  • PostgreSQL 14: Pada versi mesin minor 2.0.14.13.28.0 dan yang lebih baru, parameter ini ditambahkan untuk meningkatkan performa real-time IMCI.

  • PostgreSQL 16: Pada versi mesin minor 2.0.16.10.12.0 dan yang lebih baru, parameter ini ditambahkan untuk meningkatkan performa real-time IMCI.

polar_csi.forward_replay_wait

on|off

off

Tingkat konsistensi kueri data IMCI dan IMCI. Nilai yang valid:

  • off: konsistensi akhir. Data IMCI mungkin tertinggal dari data rowstore.

  • on: konsistensi kuat. Kueri menunggu hingga data columnstore direplay ke data terbaru sebelum dieksekusi. Saat tekanan write tinggi, mengaktifkan parameter ini dapat menyebabkan waktu tunggu yang lama.

polar_csi.forward_replay_wait_lsn_diff

0~INT_MAX

0

Latensi LSN maksimum yang diizinkan untuk sinkronisasi row-column. Jika latensi melebihi ambang batas yang ditentukan, mesin columnstore tidak lagi digunakan. Satuan: BYTE.

Catatan
  • Parameter ini hanya berlaku jika 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 yang lebih baru.

    • PostgreSQL 16: Versi mesin minor 2.0.16.10.12.0 dan yang lebih baru.

    • PostgreSQL 15 dan PostgreSQL 17: Sama dengan cakupan penerapan untuk mesin vektorisasi.

polar_csi.sync_addcolumn

on|off

off

Menentukan apakah operasi Add Column disinkronkan ke IMCI.

Catatan

Parameter ini hanya berlaku untuk versi berikut:

  • PostgreSQL 14: Versi mesin minor 2.0.14.19.40.0 dan yang lebih baru.

  • PostgreSQL 16: Versi mesin minor 2.0.16.10.12.0 dan yang lebih baru.

  • PostgreSQL 15 dan PostgreSQL 17: Sama dengan cakupan penerapan untuk mesin vektorisasi.

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: Pada versi mesin minor 2.0.14.19.40.0 dan yang lebih baru, tipe data BITSTRING, VARCHAR[], dan TEXT[] ditambahkan.

  • PostgreSQL 16: Pada versi mesin minor 2.0.16.10.12.0 dan yang lebih baru, tipe data BITSTRING, VARCHAR[], dan TEXT[] ditambahkan.