All Products
Search
Document Center

PolarDB:Instant Add Column

Last Updated:Aug 28, 2026

Pelajari tentang fitur Instant Add Column dan cara menggunakannya.

Secara tradisional, penambahan kolom ke tabel memerlukan pembangunan ulang seluruh data partisi fisik pada node penyimpanan, yang mengonsumsi sumber daya sistem secara signifikan. Fitur Instant Add Column di PolarDB-X memungkinkan Anda menambahkan kolom ke tabel berukuran apa pun hampir secara instan dengan hanya mengubah definisi tabel tanpa memodifikasi data yang sudah ada.

Prasyarat

Fitur ini hanya tersedia untuk instans PolarDB-X 2.0 versi 5.4.13-16504348 atau lebih baru.

  • Untuk instans dengan versi DN 5.7, fitur ini dinonaktifkan secara default dan harus diaktifkan secara manual. Untuk petunjuknya, lihat Penggunaan.

  • Untuk instans dengan versi DN 8.0, fitur ini diaktifkan secara default.

Catatan

Untuk memeriksa versi DN, login ke PolarDB for Xscale console. Pada halaman Configuration and Management > Basic Information instans Anda, periksa informasi kompatibilitas di bagian Configuration Information.

Batasan

  • Instant Add Column tidak mendukung penambahan kolom kunci primer.

  • Instant Add Column tidak didukung untuk tabel dengan atribut ROW_FORMAT = COMPRESSED.

    Catatan

    Jalankan pernyataan SHOW CREATE TABLE untuk memeriksa apakah suatu tabel memiliki atribut ROW_FORMAT = COMPRESSED.

  • Instant Add Column tidak didukung untuk tabel yang memiliki indeks teks penuh.

  • Instant Add Column tidak didukung untuk tabel dengan partisi fisik.

    Catatan

    Jalankan pernyataan SHOW CREATE TABLE untuk memeriksa apakah suatu tabel mengandung klausa LOCAL PARTITION BY.

  • Anda hanya dapat menggunakan INSTANT ADD COLUMN untuk menambahkan kolom setelah kolom terakhir yang sudah ada. Pembatasan ini hanya berlaku untuk instans dengan versi DN 5.7.

  • Satu pernyataan ALTER TABLE hanya boleh berisi operasi penambahan kolom. Jika pernyataan tersebut mencakup operasi lain, operasi tersebut tidak akan menggunakan fitur Instant Add Column.

Penggunaan

Parameter (versi DN 5.7)

Parameter

Level

Deskripsi

loose_innodb_support_instant_add_column

Global

Mengontrol fitur Instant Add Column:

  • ON: Mengaktifkan fitur Instant Add Column.

  • OFF: Menonaktifkan fitur Instant Add Column. Ini adalah nilai default.

Untuk mengatur parameter:

Login ke PolarDB for Xscale console. Buka Configuration and Management > Parameter Settings > Storage Layer untuk instans Anda dan atur loose_innodb_support_instant_add_column menjadi on.

Sintaksis

Ketika Anda menentukan ALGORITHM=INSTANT dalam pernyataan ALTER TABLE, PolarDB-X akan menggunakan fitur Instant Add Column. Algoritma lain seperti INPLACE atau COPY tidak menggunakan fitur ini.

  • Untuk instans dengan versi DN 8.0, PolarDB-X menggunakan fitur Instant Add Column secara default, bahkan jika Anda tidak menentukan ALGORITHM=INSTANT. Contoh:

    ALTER TABLE test ADD COLUMN col1 int;
  • Tentukan ALGORITHM=INSTANT untuk memaksa penggunaan fitur Instant Add Column. Contoh:

    ALTER TABLE test ADD COLUMN col2 int, ALGORITHM=INSTANT;
  • Jika Anda menentukan ALGORITHM=INPLACE atau ALGORITHM=COPY, PolarDB-X tidak akan menggunakan fitur Instant Add Column. Contoh:

    ALTER TABLE test ADD COLUMN col3 int, ALGORITHM=INPLACE;
    ALTER TABLE test ADD COLUMN col4 int, ALGORITHM=COPY;