Tüm Ürünler
Search
Belge Merkezi

PolarDB:What is the Instant modify column feature of PolarDB?

Son Güncelleme:Oct 07, 2026

Standart MySQL, bir sütunun veri türünü değiştirmek için COPY algoritmasını kullanır. Bu işlem, tek bir iş parçacığında tüm tabloyu yeniden oluştururken tüm yazma işlemlerini engeller. Büyük tablolar için bu işlem dakikalarca hatta saatlerce sürebilir. PolarDB for MySQL'in Anında Sütun Değiştirme (Instant Modify Column) özelliği, yalnızca tablonun meta verilerini güncelleyerek bu sorunu önler; işlem, tablo boyutundan bağımsız olarak saniyeler içinde tamamlanır.

Anında Sütun Değiştirme özelliği kademeli yayınlama aşamasındadır. Bu özelliği kullanmak için Quota Center adresine gidin, polarm_82_instant_modify_column kotasını bulun ve Apply seçeneğine tıklayın.

Desteklenen sürümler

Parametreler

Parametre Seviye Açıklama Varsayılan
loose_innodb_polar_instant_modify_column_enable Global Anında Sütun Değiştirmeyi etkinleştirir veya devre dışı bırakır. Geçerli değerler: ON, OFF OFF
loose_innodb_polar_instant_modify_column_max_times Global Özelliğin tek bir tabloda sütun türlerini değiştirebileceği maksimum sayı. Aralık: 1–64 16

Desteklenen işlemler

Anında Sütun Değiştirme, aşağıdaki veri türleri için yalnızca sütun uzunluğunu artırmayı destekler. İşlemi çalıştırmadan önce desteğin olup olmadığını doğrulamak için bu tabloyu kullanın.

Sütun türü Desteklenen değişiklik Desteklenen örnek Desteklenmeyen örnek
TINYINT, SMALLINT, MEDIUMINT, INT, BIGINT Daha geniş bir tamsayı türüne yükseltme INT → BIGINT BIGINT → INT
VARCHAR(N) Uzunluğu artırma (N değerinden N+M değerine, M > 0 olmak üzere) VARCHAR(50) → VARCHAR(300) VARCHAR(300) → VARCHAR(50)
CHAR(N) Uzunluğu artırma (N değerinden N+M değerine, M > 0 olmak üzere) CHAR(30) → CHAR(50) CHAR(50) → CHAR(30)

Aşağıdaki ek kısıtlamalar geçerlidir:

Kısıtlama Ayrıntılar
Satır formatı Yalnızca COMPACT veya DYNAMIC satır formatı
İndeksli sütunlar İndeksi olan sütunlar değiştirilemez
Bölümlenmiş tablolar Bölümlenmiş tablolar içindeki sütunlar değiştirilemez
Tam metin veya coğrafi indeksler Tam metin veya coğrafi indeksi olan tablolardaki sütunlar değiştirilemez
Birleşik DDL Anında Sütun Değiştirme, aynı deyimde diğer DDL işlemleriyle birleştirilemez

İşleminiz bu koşulları karşılamıyorsa ve ALGORITHM=INSTANT belirtirseniz aşağıdaki hata döndürülür:

ERROR 1846 (0A000): ALGORITHM=INSTANT is not supported. Reason: Cannot change column type INPLACE. Try ALGORITHM=COPY/INPLACE
İpucu: Bir DDL deyimi çalıştırmadan önce, bu işlem için INSTANT algoritmasının desteklenip desteklenmediğini kontrol etmek amacıyla EXPLAIN DDL komutunu kullanın.

Sütun türünü anında değiştirme

INSTANT algoritmasını zorlama (önerilen)

Anında Sütun Değiştirmeyi uygulamak için ALGORITHM=INSTANT belirtin. İşlem INSTANT kullanamıyorsa, sistem daha yavaş bir algoritmaya sessizce geri dönmez; bunun yerine hemen bir hata döndürür.

CREATE TABLE t(a int);

-- Verify the current table structure
SHOW CREATE TABLE t;
-- Output:
-- CREATE TABLE `t` (
--   `a` int(11) DEFAULT NULL
-- ) ENGINE=InnoDB DEFAULT CHARSET=utf8

-- Modify the column type using the INSTANT algorithm
ALTER TABLE t MODIFY COLUMN a bigint DEFAULT NULL, ALGORITHM=INSTANT;

Algoritmanın PolarDB tarafından otomatik seçilmesine izin verme

Algoritma yan tümcesini atlayın veya PolarDB for MySQL'in en verimli algoritmayı otomatik olarak seçmesi için ALGORITHM=DEFAULT belirtin.

ALTER TABLE test.test_table MODIFY COLUMN test_column bigint, ALGORITHM=DEFAULT;
ALTER TABLE test.test_table MODIFY COLUMN test_column bigint;

PolarDB for MySQL, algoritmaları aşağıdaki öncelik sırasına göre değerlendirir:

Öncelik Algoritma Davranış
1 (en yüksek) INSTANT Yalnızca meta verileri günceller. Tablo boyutundan bağımsız olarak saniyeler içinde tamamlanır. Tablo yeniden oluşturma yapılmaz.
2 INPLACE DDL işlemi sırasında eşzamanlı okuma ve yazmaya izin verir. Paralel DDL bunu daha da hızlandırabilir.
3 (en düşük) COPY Tüm tabloyu yeniden oluşturur. İşlem sırasında tablo salt okunur durumdadır.

Anında değiştirilen sütunları görüntüleme

INFORMATION_SCHEMA.INNODB_INSTANT_COLUMNS tablosu, mevcut kümede Anında Sütun Değiştirme kullanılarak değiştirilen tüm sütunları kaydeder. Tabloda yalnızca bu özellik tarafından değiştirilen sütunlar görünür.

SELECT * FROM INFORMATION_SCHEMA.INNODB_INSTANT_COLUMNS;

Tablo şeması:

SHOW CREATE TABLE INFORMATION_SCHEMA.INNODB_INSTANT_COLUMNS;
-- CREATE TEMPORARY TABLE `INNODB_INSTANT_COLUMNS` (
--   `TABLE_ID` bigint(21) unsigned NOT NULL DEFAULT '0',
--   `TABLE_NAME` varchar(193) NOT NULL DEFAULT '',
--   `SCHEMA_NAME` varchar(193) NOT NULL DEFAULT '',
--   `COLUMN_NAME` varchar(193) NOT NULL DEFAULT '',
--   `MTYPE` int(11) NOT NULL DEFAULT '0',
--   `PRTYPE` int(11) NOT NULL DEFAULT '0',
--   `LEN` int(11) NOT NULL DEFAULT '0',
--   `HAS_DEFAULT` int(1) NOT NULL DEFAULT '0',
--   `DEFAULT_VALUE` mediumblob,
--   `CURRENT_VERSION` int(11) NOT NULL DEFAULT '0',
--   `OLD_VERSION_INFO` blob
-- ) ENGINE=InnoDB DEFAULT CHARSET=utf8

Alan açıklamaları:

Alan Açıklama
TABLE_ID Tablo kimliği
TABLE_NAME Tablo adı
SCHEMA_NAME Şema adı
COLUMN_NAME Sütun adı
MTYPE Sütun türü
PRTYPE Hassas sütun türü veya nitelikler
LEN Sütun uzunluğu
HAS_DEFAULT Sütunun varsayılan değeri olup olmadığı
DEFAULT_VALUE Sütunun varsayılan değeri
CURRENT_VERSION Sütunun sürüm bilgisi
OLD_VERSION_INFO Sütunun geçmiş tür bilgisi
Daha önce Anında Sütun Değiştirme ile değiştirilmiş bir sütunda tam tablo yeniden oluşturması gerektiren bir DDL işlemi (örneğin DROP COLUMN ) gerçekleştirilirse, o sütuna ait kayıt INNODB_INSTANT_COLUMNS tablosundan kaldırılır.