Instant ADD COLUMN - PolarDB

Topik ini menjelaskan fitur Instant ADD COLUMN dan cara menggunakannya untuk menambahkan kolom ke tabel secara instan.

Saat Anda menambahkan kolom ke tabel dengan metode tradisional, node data harus membangun ulang data di semua shard fisik. Proses ini membutuhkan sejumlah besar sumber daya sistem. PolarDB-X menyediakan fitur Instant ADD COLUMN yang menambahkan kolom hanya dengan memperbarui definisi tabel tanpa mengubah data yang ada. Fitur ini memastikan penambahan kolom dapat dilakukan dengan cepat, terlepas dari ukuran tabel.

Prasyarat

Instans Anda adalah instans PolarDB-X 2.0 yang menjalankan versi V5.4.13-16504348 atau yang lebih baru.

Secara default, fitur ini dinonaktifkan pada instans dengan versi node data (DN) 5.7. Untuk mengaktifkannya, atur parameter support_instant_add_column ke ON. Informasi lebih lanjut dapat ditemukan di bagian "Penggunaan" dalam topik ini.
Untuk instans dengan DN versi 8.0, fitur ini diaktifkan secara otomatis.

Catatan

Untuk memeriksa versi DN, masuk ke Konsol PolarDB-X, buka halaman Configuration Management > Basic Information, lalu periksa nilai parameter Compatibility di bagian Configuration Information.

Batasan

Fitur ini tidak dapat digunakan untuk menambahkan kolom kunci utama.
Fitur ini tidak dapat digunakan untuk menambahkan kolom ke tabel dengan atribut ROW_FORMAT disetel ke COMPRESSED.
Catatan
Jalankan pernyataan SHOW CREATE TABLE untuk memeriksa apakah atribut ROW_FORMAT tabel disetel ke COMPRESSED.
Fitur ini tidak dapat digunakan untuk menambahkan kolom ke tabel yang berisi indeks teks penuh.
Fitur ini tidak dapat digunakan untuk menambahkan kolom ke tabel yang berisi partisi fisik.
Catatan
Jalankan pernyataan SHOW CREATE TABLE untuk memeriksa apakah tabel berisi klausa LOCAL PARTITION BY.
Untuk instans dengan DN versi 5.7, pernyataan INSTANT ADD COLUMN hanya dapat menambahkan kolom di akhir kolom yang ada.
Agar fitur ini berlaku, pernyataan ALTER TABLE harus hanya mencakup operasi penambahan kolom. Jika operasi lain termasuk dalam pernyataan ALTER TABLE yang sama, fitur ini tidak akan berlaku.

Penggunaan

Parameter (Versi DN: 5.7)

Parameter

Tingkat

Deskripsi

loose_innodb_support_instant_add_column

Global

Menentukan apakah akan mengaktifkan fitur Instant ADD COLUMN. Nilai yang valid:

ON
OFF (default)

Untuk mengaktifkan fitur Instant ADD COLUMN, lakukan langkah berikut:

Masuk ke Konsol PolarDB-X, buka halaman Configuration Management > Parameter Settings > Storage Layer, lalu atur parameter loose_innodb_support_instant_add_column ke ON.

Pernyataan

Untuk mengaktifkan fitur Instant ADD COLUMN saat menambahkan kolom, tentukan ALGORITHM = INSTANT dalam pernyataan ALTER TABLE ADD COLUMN. Jika algoritma lain seperti INPLACE atau COPY ditentukan, fitur Instant ADD COLUMN akan dinonaktifkan.

Secara default, fitur Instant ADD COLUMN diaktifkan untuk instans dengan DN versi 8.0, bahkan jika ALGORITHM=INSTANT tidak ditentukan dalam pernyataan ALTER TABLE ADD COLUMN. Contoh pernyataan:
```
ALTER TABLE test ADD COLUMN col1 int;
```
Untuk memaksa mengaktifkan fitur Instant ADD COLUMN, tentukan ALGORITHM=INSTANT dalam pernyataan ALTER TABLE ADD COLUMN. Contoh pernyataan:
```
ALTER TABLE test ADD COLUMN col2 int, ALGORITHM=INSTANT;
```
Untuk menonaktifkan fitur Instant ADD COLUMN, tentukan ALGORITHM=INPLACE atau ALGORITHM=COPY dalam pernyataan ALTER TABLE ADD COLUMN. Contoh pernyataan:
```
ALTER TABLE test ADD COLUMN col3 int, ALGORITHM=INPLACE;
ALTER TABLE test ADD COLUMN col4 int, ALGORITHM=COPY;
```