全部产品
Search
文档中心

PolarDB:Parameter lapisan komputasi untuk PolarDB-X

更新时间:Nov 11, 2025

Topik ini menjelaskan parameter lapisan komputasi untuk PolarDB-X.

Catatan

Hanya Instans Perusahaan PolarDB-X yang mendukung parameter lapisan komputasi.

Nama variabel

Perlu restart

Nilai default

Cakupan

Deskripsi

PLAN_CACHE

Tidak

FALSE

[TRUE|FALSE]

Mengaktifkan atau menonaktifkan cache rencana.

ENABLE_RECYCLEBIN

Tidak

FALSE

[TRUE|FALSE]

Mengaktifkan atau menonaktifkan Keranjang daur ulang.

SHOW_TABLES_CACHE

Tidak

FALSE

[TRUE|FALSE]

Mengontrol apakah akan menyimpan cache hasil pernyataan SHOW TABLES.

MERGE_CONCURRENT

Tidak

FALSE

[TRUE|FALSE]

Mengaktifkan atau menonaktifkan eksekusi paralel penuh. Parameter ini terutama memengaruhi tingkat paralelisme (DOP) untuk pernyataan Data Definition Language (DDL) dan kueri sederhana yang sepenuhnya dipush down.

MERGE_UNION

Tidak

FALSE

[TRUE|FALSE]

Parameter ini dinonaktifkan secara default. Jika Anda mengaktifkannya, optimasi UNION tidak dilakukan pada pernyataan SQL fisik, dan pernyataan SQL fisik yang dipush down dieksekusi secara sekuensial.

MERGE_UNION_SIZE

Tidak

-1

[0-10000]

Jumlah pernyataan SQL fisik yang digabung menggunakan UNION. Secara default, sistem menentukan nilai ini secara otomatis berdasarkan jumlah koneksi yang tersedia di Kolam koneksi.

TABLE_META_CACHE_EXPIRE_TIME

Tidak

300

[0-180000]

Waktu hidup (TTL) untuk cache metadata.

COLUMN_LABEL_INSENSITIVE

Tidak

TRUE

[FALSE|TRUE]

Mengontrol apakah label kolom yang dikembalikan peka terhadap huruf besar/kecil.

RECORD_SQL

Tidak

TRUE

[FALSE|TRUE]

Mengaktifkan atau menonaktifkan Log audit.

SOCKET_TIMEOUT

Tidak

900000

[0~3600000]

Timeout koneksi untuk pernyataan SQL fisik.

TRANSACTION_POLICY

Tidak

TSO

[XA|TSO|TSO_READONLY]

Kebijakan transaksi.

SHARE_READ_VIEW

Tidak

FALSE

[TRUE|FALSE]

Mengaktifkan atau menonaktifkan fitur ReadView bersama.

ENABLE_TRX_SINGLE_SHARD_OPTIMIZATION

Tidak

TRUE

[TRUE|FALSE]

Mengaktifkan atau menonaktifkan optimasi single-shard untuk transaksi.

GET_TSO_TIMEOUT

Tidak

10

[1-1800]

Timeout untuk mendapatkan timestamp Timestamp Oracle (TSO).

MAX_TRX_DURATION

Tidak

28.800

[1-180000]

Timeout fisik untuk sebuah transaksi.

TRANSACTION_ISOLATION

Tidak

REPEATABLE-READ

[READ-UNCOMMITTED|READ-COMMITTED|REPEATABLE-READ|SERIALIZABLE]

Tingkat isolasi transaksi.

GROUP_CONCURRENT_BLOCK

Tidak

TRUE

[TRUE|FALSE]

Kebijakan eksekusi pada level sharding database saat tidak dalam mode Pemrosesan Paralel Masif (MPP).

SEQUENTIAL_CONCURRENT_POLICY

Tidak

FALSE

[TRUE|FALSE]

Kebijakan eksekusi sekuensial untuk permintaan konkuren saat tidak dalam mode MPP.

DML_SKIP_DUPLICATE_CHECK_FOR_PK

Tidak

TRUE

[TRUE|FALSE]

Mengontrol apakah akan melewati pemeriksaan konflik kunci primer selama eksekusi pernyataan Data Manipulation Language (DML).

DML_SKIP_CRUCIAL_ERR_CHECK

Tidak

FALSE

[TRUE|FALSE]

Mengontrol apakah transaksi dengan kesalahan DML diperbolehkan untuk dikomit.

DML_USE_RETURNING

Tidak

TRUE

[TRUE|FALSE]

Mengontrol apakah akan menggunakan klausa `RETURNING` untuk optimasi.

BROADCAST_DML

Tidak

FALSE

[TRUE|FALSE]

Mengontrol apakah penulisan ke tabel broadcast dapat melewati transaksi terdistribusi.

SEQUENCE_STEP

Tidak

10.000

[1-10000000]

Ukuran langkah untuk sebuah sequence. Nilai default adalah 100.000.

MERGE_DDL_TIMEOUT

Tidak

0

[1-10000000]

Timeout untuk koneksi DDL fisik. Nilai default adalah 0, yang berarti tanpa timeout.

MERGE_DDL_CONCURRENT

Tidak

FALSE

[FALSE|TRUE]

Mengontrol apakah pernyataan DDL dieksekusi dalam mode paralel penuh. Secara default, pernyataan DDL dieksekusi dengan konkurensi tingkat database.

SLOW_SQL_TIME

Tidak

1.000

[1-180000]

Ambang batas untuk pernyataan SQL lambat.

LOAD_DATA_BATCH_INSERT_SIZE

Tidak

1.024

[1-180000]

Jumlah catatan dalam setiap penyisipan batch untuk pernyataan `LOAD DATA`.

LOAD_DATA_CACHE_BUFFER_SIZE

Tidak

60

[1-180000]

Ukuran buffer cache untuk pernyataan `LOAD DATA`. Nilai default adalah 60 MB. Parameter ini terutama digunakan untuk pembatasan laju.

MAX_ALLOWED_PACKET

Tidak

16.777.216

[4194304–33554432]

Ukuran paket maksimum.

KILL_CLOSE_STREAM

Tidak

FALSE

[FALSE|TRUE]

Mengaktifkan atau menonaktifkan fitur terminasi awal untuk aliran koneksi fisik.

ALLOW_SIMPLE_SEQUENCE

Tidak

FALSE

[FALSE|TRUE]

Mengontrol apakah penggunaan sequence sederhana diperbolehkan.

MAX_PARAMETERIZED_SQL_LOG_LENGTH

Tidak

5.000

[1-1000000]

Panjang maksimum pernyataan SQL terparameterisasi yang dapat dicetak dalam log.

FORBID_EXECUTE_DML_ALL

Tidak

TRUE

[TRUE|FALSE]

Mengontrol apakah operasi `DELETE` dan `UPDATE` pada seluruh tabel dilarang.

GROUP_SEQ_CHECK_INTERVAL

Ya

60

[1-36000]

Interval untuk memeriksa nilai yang dimasukkan secara eksplisit. Satuan: detik.

JOIN_BLOCK_SIZE

Ya

300

[1-100000]

Jumlah nilai `IN` untuk join Batched Key Access (BKA) saat pemangkasan dinamis dinonaktifkan.

LOOKUP_JOIN_MAX_BATCH_SIZE

Ya

6.400

[1-100000]

Jumlah maksimum nilai `IN` untuk join BKA.

LOOKUP_JOIN_MIN_BATCH_SIZE

Ya

100

[1-100000]

Jumlah minimum nilai `IN` untuk join BKA.

PURGE_TRANS_INTERVAL

Ya

300

[1-180000]

Interval untuk purge log transaksi.

PURGE_TRANS_BEFORE

Ya

1.800

[1-180000]

Usia log transaksi yang akan dipurge. Sistem membuang log yang lebih tua dari nilai ini.

ENABLE_BACKGROUND_STATISTIC_COLLECTION

Tidak

TRUE

[TRUE|FALSE]

Mengontrol apakah koleksi statistik latar belakang diaktifkan.

GENERAL_DYNAMIC_SPEED_LIMITATION

Tidak

-1

[-1-10000000]

Batas kecepatan dinamis untuk pengisian ulang data dan validasi. Nilai default adalah -1, yang menunjukkan batas 10.000 baris per detik.

PARALLELISM

Tidak

-1

[1-1024]

DOP untuk node tunggal. Secara default, sistem menentukan nilai ini berdasarkan spesifikasi node.

LOGICAL_DB_TIME_ZONE

Tidak

SYSTEM

[SYSTEM|±HH:mm]

Zona waktu database.

MPP_PARALLELISM

Tidak

-1

[1-1024]

DOP untuk mode eksekusi MPP. Secara default, sistem menentukan nilai ini berdasarkan spesifikasi node.

DATABASE_PARALLELISM

Tidak

0

[0-1024]

Jumlah pernyataan SQL yang dapat dikirim secara konkuren oleh satu kueri ke satu node data (DN). Nilai ini digunakan untuk menghitung DOP untuk operasi pemindaian.

POLARDBX_PARALLELISM

Tidak

0

[0-1024]

DOP maksimum untuk satu kueri pada satu node komputasi (CN). Nilai default adalah jumlah core CPU.

MPP_METRIC_LEVEL

Tidak

3

[0|1|2|3]

Tingkat detail untuk mengumpulkan statistik kinerja selama komputasi. Level yang lebih tinggi menunjukkan granularitas pengumpulan yang lebih halus.

ENABLE_COMPLEX_DML_CROSS_DB

Tidak

TRUE

[TRUE|FALSE]

Mengontrol apakah pernyataan DML kompleks lintas database didukung.

PER_QUERY_MEMORY_LIMIT

Ya

-1

[-1-9223372036854775807]

Batas memori untuk pool memori tingkat kueri. Nilai default adalah sepertiga dari ukuran global connection pool.

ENABLE_SPILL

Tidak

FALSE

[FALSE|TRUE]

Mengaktifkan atau menonaktifkan spill tabel sementara ke disk.

CONN_POOL_MIN_POOL_SIZE

Tidak

20

[0-60]

Jumlah minimum koneksi ke shard database fisik.

CONN_POOL_MAX_POOL_SIZE

Tidak

60

[1-1600]

Jumlah maksimum koneksi ke shard database fisik.

CONN_POOL_MAX_WAIT_THREAD_COUNT

Tidak

0

[-1-8192]

Jumlah maksimum thread yang menunggu koneksi ke satu shard database. Parameter ini berlaku untuk Kolam koneksi Druid.

CONN_POOL_IDLE_TIMEOUT

Tidak

30

[1-60]

Timeout untuk koneksi fisik yang idle.

CONN_POOL_BLOCK_TIMEOUT

Tidak

5.000

[1000-60000]

Waktu maksimum menunggu koneksi dari Kolam koneksi fisik.

CONN_POOL_XPROTO_MAX_POOLED_SESSION_PER_INST

Tidak

512

[1-8192]

Jumlah maksimum sesi yang di-cache per node penyimpanan. Ini berlaku untuk sesi yang menggunakan protokol eksklusif.

XPROTO_MAX_DN_CONCURRENT

Tidak

500

[1-8192]

Jumlah maksimum permintaan konkuren per node penyimpanan. Ini berlaku untuk permintaan yang menggunakan protokol eksklusif. Pada 23 Oktober 2023, nilai default diubah menjadi 2000 untuk memenuhi kebutuhan sebagian besar skenario produksi dan uji stres.

XPROTO_MAX_DN_WAIT_CONNECTION

Tidak

32

[1-8192]

Jumlah maksimum permintaan yang menunggu per node penyimpanan. Ini berlaku untuk permintaan yang menggunakan protokol eksklusif. Pada 13 Juni 2024, nilai default diubah menjadi 2000 untuk memenuhi kebutuhan sebagian besar skenario produksi dan uji stres.

MERGE_SORT_BUFFER_SIZE

Tidak

2.048

[1024-81920]

Ukuran buffer untuk operasi merge sort pada lapisan TableScan. Nilai default adalah 2 MB.

WORKLOAD_TYPE

Tidak

[AP|TP]

Jenis beban kerja untuk suatu kueri. Jika tidak ditentukan, sistem secara otomatis mengidentifikasi jenis beban kerja berdasarkan biaya.

EXECUTOR_MODE

Tidak

[MPP|TP_LOCAL|AP_LOCAL]

Mode eksekusi untuk suatu kueri. Jika tidak ditentukan, sistem memilih mode eksekusi berdasarkan jenis beban kerja.

ENABLE_MASTER_MPP

Tidak

FALSE

[TRUE|FALSE]

Mengontrol apakah fitur MPP diaktifkan pada Instans utama.

LOOKUP_JOIN_BLOCK_SIZE_PER_SHARD

Ya

50

[1-100000]

Jumlah nilai `IN` per shard untuk join BKA saat pemangkasan diaktifkan.

ENABLE_RUNTIME_FILTER

Tidak

TRUE

[TRUE|FALSE]

Mengaktifkan atau menonaktifkan filter runtime.

FEEDBACK_WORKLOAD_AP_THRESHOLD

Tidak

FALSE

[TRUE|FALSE]

Mengaktifkan atau menonaktifkan umpan balik pemrosesan transaksional dan analitik hibrida (HTAP) untuk kueri pemrosesan analitik (AP).

FEEDBACK_WORKLOAD_TP_THRESHOLD

Tidak

FALSE

[TRUE|FALSE]

Mengaktifkan atau menonaktifkan umpan balik HTAP untuk kueri pemrosesan transaksional (TP).

MASTER_READ_WEIGHT

Tidak

-1

[0-100]

Nilai yang menentukan distribusi trafik baca. Persentase trafik yang diarahkan ke node data read-only dihitung sebagai `(100 - MASTER_READ_WEIGHT)`. Sisanya diarahkan ke node data Instans utama.

SHOW_ALL_PARAMS

Tidak

FALSE

[TRUE|FALSE]

Mengontrol apakah `SHOW VARIABLES` menampilkan semua parameter.

FORCE_READ_OUTSIDE_TX

Tidak

FALSE

[TRUE|FALSE]

Mengontrol apakah akan memaksa membuka beberapa koneksi ke satu shard database dalam satu transaksi.

ENABLE_COROUTINE

Ya

FALSE

[TRUE|FALSE]

Mengaktifkan atau menonaktifkan korutin Wisp.

TRUNCATE_TABLE_WITH_GSI

Tidak

FALSE

[TRUE|FALSE]

Mengontrol apakah `TRUNCATE TABLE` diizinkan pada tabel yang memiliki indeks sekunder global (GSI).

DDL_ON_GSI

Tidak

FALSE

[TRUE|FALSE]

Mengontrol apakah pernyataan DDL diizinkan dieksekusi langsung pada tabel GSI.

DML_ON_GSI

Tidak

FALSE

[TRUE|FALSE]

Mengontrol apakah pernyataan DML diizinkan dieksekusi langsung pada tabel GSI.

ENABLE_HASH_JOIN

Tidak

TRUE

[TRUE|FALSE]

Mengontrol apakah pengoptimal dapat menghasilkan node HashJoin selama optimasi rencana kueri.

ENABLE_BKA_JOIN

Tidak

TRUE

[TRUE|FALSE]

Mengontrol apakah pengoptimal dapat menghasilkan node BKAJoin selama optimasi rencana kueri.

ENABLE_NL_JOIN

Tidak

TRUE

[TRUE|FALSE]

Mengontrol apakah pengoptimal dapat menghasilkan node NLJoin selama optimasi rencana kueri.

ENABLE_SEMI_NL_JOIN

Tidak

TRUE

[TRUE|FALSE]

Mengontrol apakah pengoptimal dapat mengonversi SemiJoin menjadi NLJoin selama optimasi rencana kueri.

ENABLE_SEMI_HASH_JOIN

Tidak

TRUE

[TRUE|FALSE]

Mengontrol apakah pengoptimal dapat mengonversi SemiJoin menjadi HashJoin selama optimasi rencana kueri.

ENABLE_SEMI_BKA_JOIN

Tidak

TRUE

[TRUE|FALSE]

Mengontrol apakah pengoptimal dapat mengonversi SemiJoin menjadi BKAJoin selama optimasi rencana kueri.

ENABLE_SEMI_SORT_MERGE_JOIN

Tidak

TRUE

[TRUE|FALSE]

Mengontrol apakah pengoptimal dapat mengonversi SemiJoin menjadi MergeJoin selama optimasi rencana kueri.

ENABLE_MATERIALIZED_SEMI_JOIN

Tidak

TRUE

[TRUE|FALSE]

Mengontrol apakah pengoptimal dapat mengonversi SemiJoin menjadi MaterializedJoin selama optimasi rencana kueri.

ENABLE_SEMI_JOIN_REORDER

Tidak

TRUE

[TRUE|FALSE]

Mengontrol apakah pengoptimal dapat menyertakan SemiJoin dalam pengurutan ulang Cost-Based Optimizer (CBO).

ENABLE_HASH_AGG

Tidak

TRUE

[TRUE|FALSE]

Mengontrol apakah pengoptimal dapat menghasilkan node HashAgg.

ENABLE_PARTIAL_AGG

Tidak

TRUE

[TRUE|FALSE]

Mengontrol apakah pengoptimal dapat membagi agregasi menjadi dua tahap.

ENABLE_SORT_AGG

Tidak

TRUE

[TRUE|FALSE]

Mengontrol apakah pengoptimal dapat menghasilkan node SortAgg.

ENABLE_PUSH_PROJECT

Tidak

TRUE

[TRUE|FALSE]

Mengontrol apakah pengoptimal dapat melakukan pushdown Project.

ENABLE_PUSH_JOIN

Tidak

TRUE

[TRUE|FALSE]

Mengontrol apakah pengoptimal dapat melakukan pushdown Join.

ENABLE_PUSH_AGG

Tidak

TRUE

[TRUE|FALSE]

Mengontrol apakah pengoptimal dapat melakukan pushdown Aggregation.

ENABLE_CBO_PUSH_AGG

Tidak

TRUE

[TRUE|FALSE]

Mengontrol apakah pengoptimal dapat mendorong agregasi melalui join.

ENABLE_PUSH_SORT

Tidak

TRUE

[TRUE|FALSE]

Mengontrol apakah pengoptimal dapat melakukan pushdown Sort.

ENABLE_STATISTIC_FEEDBACK

Tidak

TRUE

[TRUE|FALSE]

Mengontrol apakah koreksi statistik berbasis umpan balik diaktifkan.

ENABLE_CBO_PUSH_JOIN

Tidak

TRUE

[TRUE|FALSE]

Mengontrol apakah pengoptimal dapat melakukan optimasi pass-through join.

ENABLE_SORT_JOIN_TRANSPOSE

Tidak

TRUE

[TRUE|FALSE]

Mengontrol apakah pengoptimal dapat mendorong sort melalui join.

CHUNK_SIZE

Tidak

1.024

[1-10240]

Ukuran batch untuk pelaksana. Pelaksana memproses data dalam batch sebesar ukuran ini.

ENABLE_SORT_MERGE_JOIN

Tidak

TRUE

[TRUE|FALSE]

Mengontrol apakah pengoptimal dapat menghasilkan node SortMergeJoin selama optimasi rencana kueri.

ENABLE_BKA_PRUNING

Tidak

TRUE

[TRUE|FALSE]

Mengaktifkan atau menonaktifkan fitur pemangkasan untuk join BKA.

ENABLE_SPM

Tidak

TRUE

[TRUE|FALSE]

Menentukan apakah manajemen rencana eksekusi diaktifkan.

ENABLE_EXPRESSION_VECTORIZATION

Tidak

TRUE

[TRUE|FALSE]

Mengaktifkan atau menonaktifkan vektorisasi untuk ekspresi.

FORCE_DDL_ON_LEGACY_ENGINE

Tidak

TRUE

[TRUE|FALSE]

Menentukan apakah mesin DDL baru diaktifkan.

PURE_ASYNC_DDL_MODE

Tidak

FALSE

[TRUE|FALSE]

Mengontrol apakah tugas DDL dieksekusi dalam mode non-blocking (asinkron). Jika diaktifkan, klien langsung mengembalikan respons setelah mengirimkan pernyataan DDL. Anda dapat memeriksa status eksekusi dengan menjalankan `SHOW [FULL] DDL`.

DDL_JOB_REQUEST_TIMEOUT

Tidak

90000

[1-9223372036854775807]

Timeout maksimum untuk tugas DDL. Nilai default adalah 25 hari.

LOGICAL_DDL_PARALLELISM

Tidak

1

[1-10240]

DOP untuk eksekusi DDL logis. Nilai 1 berarti tugas DDL dieksekusi secara sekuensial.

ENABLE_BROADCAST_RANDOM_READ

Tidak

TRUE

[TRUE|FALSE]

Mengaktifkan atau menonaktifkan optimasi baca acak untuk tabel broadcast.

STORAGE_DELAY_THRESHOLD

Tidak

16777216s

[0-16777216]

Ambang batas latensi sinkronisasi untuk DN sebagaimana dirasakan oleh CN. Jika latensi DN read-only melebihi ambang batas ini, trafik baca ditangani berdasarkan kebijakan `DELAY_EXECUTION_STRATEGY`.

DELAY_EXECUTION_STRATEGY

Tidak

CONTINUE_TO_SLAVE

[CONTINUE_TO_SLAVE | CHANGE_TO_MASTER | THROW_EXCEPTION]

Kebijakan yang digunakan ketika latensi DN read-only melebihi `STORAGE_DELAY_THRESHOLD`. Nilai yang valid:

  • CONTINUE_TO_SLAVE: Trafik baca tetap diarahkan ke DN read-only meskipun latensinya melebihi ambang batas.

  • CHANGE_TO_MASTER: Trafik baca diarahkan ke DN read-only yang sehat. Jika semua DN read-only melebihi ambang batas latensi, trafik diarahkan ke DN Instans utama.

  • THROW_EXCEPTION: Kueri yang diarahkan ke DN read-only gagal dengan error jika semua DN read-only melebihi ambang batas latensi.

STORAGE_BUSY_THRESHOLD

Tidak

100

[0-16777216]

Ambang batas jumlah thread aktif pada DN read-only. Jika jumlah thread aktif DN read-only melebihi ambang batas ini, DN tersebut dianggap sibuk, dan router menghindari mengirimkan trafik baca kepadanya. Jika semua DN read-only sibuk, trafik diarahkan ke DN read-only acak.

ENABLE_CONSISTENT_REPLICA_READ

Tidak

TRUE

[TRUE|FALSE]

Mengaktifkan atau menonaktifkan pembacaan konsisten dari replika.

TRUE: Trafik yang diarahkan ke DN read-only dapat memenuhi persyaratan pembacaan konsisten. Anda dapat membaca data terbaru yang telah dikomit.

FALSE: Kesegaran data dari pembacaan DN read-only bergantung pada latensi sinkronisasi antara instans utama dan replika.

SUPPORT_INSTANT_ADD_COLUMN

Tidak

OFF

[ON|OFF]

Mengaktifkan atau menonaktifkan fitur Penambahan kolom instan. Aktifkan fitur ini menggunakan pernyataan SET GLOBAL.

ENABLE_STATEMENTS_SUMMARY

Tidak

true

[true|false]

Mengaktifkan atau menonaktifkan agregasi pernyataan SQL.

STATEMENTS_SUMMARY_PERCENT

Tidak

1

[0-100]

Persentase pernyataan SQL yang akan diagregasi.