show variables like 'xengine_disable_online_ddl'; Variable_name Value xengine_disable_online_ddl 0 set @xengine_disable_online_ddl_saved = @@xengine_disable_online_ddl; set xengine_disable_online_ddl = 1; ERROR HY000: Variable 'xengine_disable_online_ddl' is a GLOBAL variable and should be set with SET GLOBAL set global xengine_disable_online_ddl = 1; ############## ### basic mixture tests of INSTANT/INPLACE/COPY DDL ############## # CREATE TABLE ####### CREATE TABLE t1( id INT NOT NULL, col_to_drop INT, c1 INT DEFAULT 1, c2 VARCHAR(70), col_to_extend VARCHAR(70), c3 INT NOT NULL, c4 INT NULL, chk_col INT, k1_col INT, k2_col INT, UNIQUE KEY k1(k1_col), KEY k2(k2_col), KEY vis_key(c1) VISIBLE, KEY inv_key(c2) INVISIBLE, CONSTRAINT old_chk1 CHECK(chk_col < 100), CONSTRAINT old_chk2 CHECK(chk_col > 10), PRIMARY KEY(col_to_drop) ) ENGINE=XENGINE; INSERT INTO t1 VALUES(1, 1, 2, 'aa', 'abc', 2, 2, 20, 2, 1); INSERT INTO t1 VALUES(2, 2, 4, 'bb', 'cde', 4, 4, 40, 4, 1); ####### # INSTANT DDL ####### ALTER TABLE t1 ADD COLUMN (app_col TEXT, app_col1 INT), ALTER c1 DROP DEFAULT, ALTER c2 SET DEFAULT 'aaaa', RENAME TO tt, ALGORITHM = INSTANT; SHOW CREATE TABLE tt; Table Create Table tt CREATE TABLE `tt` ( `id` int(11) NOT NULL, `col_to_drop` int(11) NOT NULL, `c1` int(11), `c2` varchar(70) COLLATE utf8mb4_general_ci DEFAULT 'aaaa', `col_to_extend` varchar(70) COLLATE utf8mb4_general_ci DEFAULT NULL, `c3` int(11) NOT NULL, `c4` int(11) DEFAULT NULL, `chk_col` int(11) DEFAULT NULL, `k1_col` int(11) DEFAULT NULL, `k2_col` int(11) DEFAULT NULL, `app_col` text COLLATE utf8mb4_general_ci, `app_col1` int(11) DEFAULT NULL, PRIMARY KEY (`col_to_drop`), UNIQUE KEY `k1` (`k1_col`), KEY `k2` (`k2_col`), KEY `vis_key` (`c1`), KEY `inv_key` (`c2`) /*!80000 INVISIBLE */, CONSTRAINT `old_chk1` CHECK ((`chk_col` < 100)), CONSTRAINT `old_chk2` CHECK ((`chk_col` > 10)) ) ENGINE=XENGINE DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci ####### # Inplace without rebuild ####### ALTER TABLE tt ALTER INDEX vis_key INVISIBLE, ALTER INDEX inv_key VISIBLE, ALGORITHM = INPLACE; ALTER TABLE tt DROP KEY k1, DROP KEY k2, ADD INDEX key1(c4) COMMENT 'secondary key1', ADD UNIQUE INDEX key2(c3) COMMENT 'unique secondary key2', MODIFY COLUMN col_to_extend VARCHAR(100), RENAME COLUMN col_to_drop to col_to_drop_later, RENAME INDEX vis_key TO iv_key, RENAME INDEX inv_key TO v_key, ALGORITHM = INPLACE; SHOW CREATE TABLE tt; Table Create Table tt CREATE TABLE `tt` ( `id` int(11) NOT NULL, `col_to_drop_later` int(11) NOT NULL, `c1` int(11), `c2` varchar(70) COLLATE utf8mb4_general_ci DEFAULT 'aaaa', `col_to_extend` varchar(100) COLLATE utf8mb4_general_ci DEFAULT NULL, `c3` int(11) NOT NULL, `c4` int(11) DEFAULT NULL, `chk_col` int(11) DEFAULT NULL, `k1_col` int(11) DEFAULT NULL, `k2_col` int(11) DEFAULT NULL, `app_col` text COLLATE utf8mb4_general_ci, `app_col1` int(11) DEFAULT NULL, PRIMARY KEY (`col_to_drop_later`), UNIQUE KEY `key2` (`c3`) COMMENT 'unique secondary key2', KEY `iv_key` (`c1`) /*!80000 INVISIBLE */, KEY `v_key` (`c2`), KEY `key1` (`c4`) COMMENT 'secondary key1', CONSTRAINT `old_chk1` CHECK ((`chk_col` < 100)), CONSTRAINT `old_chk2` CHECK ((`chk_col` > 10)) ) ENGINE=XENGINE DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci ####### # Inplace DDL with rebuild, aka. online copy ddl ####### ALTER TABLE tt DROP PRIMARY KEY, ADD PRIMARY KEY(id), DROP COLUMN col_to_drop_later, ADD COLUMN email VARCHAR(32) AFTER c2, MODIFY COLUMN c3 INT AFTER c4, ALGORITHM = INPLACE; ERROR 0A000: ALGORITHM=INPLACE is not supported for this operation. Try ALGORITHM=COPY. SHOW CREATE TABLE tt; Table Create Table tt CREATE TABLE `tt` ( `id` int(11) NOT NULL, `col_to_drop_later` int(11) NOT NULL, `c1` int(11), `c2` varchar(70) COLLATE utf8mb4_general_ci DEFAULT 'aaaa', `col_to_extend` varchar(100) COLLATE utf8mb4_general_ci DEFAULT NULL, `c3` int(11) NOT NULL, `c4` int(11) DEFAULT NULL, `chk_col` int(11) DEFAULT NULL, `k1_col` int(11) DEFAULT NULL, `k2_col` int(11) DEFAULT NULL, `app_col` text COLLATE utf8mb4_general_ci, `app_col1` int(11) DEFAULT NULL, PRIMARY KEY (`col_to_drop_later`), UNIQUE KEY `key2` (`c3`) COMMENT 'unique secondary key2', KEY `iv_key` (`c1`) /*!80000 INVISIBLE */, KEY `v_key` (`c2`), KEY `key1` (`c4`) COMMENT 'secondary key1', CONSTRAINT `old_chk1` CHECK ((`chk_col` < 100)), CONSTRAINT `old_chk2` CHECK ((`chk_col` > 10)) ) ENGINE=XENGINE DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci SELECT * FROM tt; id col_to_drop_later c1 c2 col_to_extend c3 c4 chk_col k1_col k2_col app_col app_col1 1 1 2 aa abc 2 2 20 2 1 NULL NULL 2 2 4 bb cde 4 4 40 4 1 NULL NULL DROP TABLE tt; set global xengine_disable_online_ddl = 2; CREATE TABLE t1( id INT NOT NULL, col_to_drop INT, c1 INT DEFAULT 1, c2 VARCHAR(70), col_to_extend VARCHAR(70), c3 INT NOT NULL, c4 INT NULL, chk_col INT, k1_col INT, k2_col INT, UNIQUE KEY k1(k1_col), KEY k2(k2_col), KEY vis_key(c1) VISIBLE, KEY inv_key(c2) INVISIBLE, CONSTRAINT old_chk1 CHECK(chk_col < 100), CONSTRAINT old_chk2 CHECK(chk_col > 10), PRIMARY KEY(col_to_drop) ) ENGINE=XENGINE; INSERT INTO t1 VALUES(1, 1, 2, 'aa', 'abc', 2, 2, 20, 2, 1); INSERT INTO t1 VALUES(2, 2, 4, 'bb', 'cde', 4, 4, 40, 4, 1); ####### # INSTANT DDL ####### ALTER TABLE t1 ADD COLUMN (app_col TEXT, app_col1 INT), ALTER c1 DROP DEFAULT, ALTER c2 SET DEFAULT 'aaaa', RENAME TO tt, ALGORITHM = INSTANT; SHOW CREATE TABLE tt; Table Create Table tt CREATE TABLE `tt` ( `id` int(11) NOT NULL, `col_to_drop` int(11) NOT NULL, `c1` int(11), `c2` varchar(70) COLLATE utf8mb4_general_ci DEFAULT 'aaaa', `col_to_extend` varchar(70) COLLATE utf8mb4_general_ci DEFAULT NULL, `c3` int(11) NOT NULL, `c4` int(11) DEFAULT NULL, `chk_col` int(11) DEFAULT NULL, `k1_col` int(11) DEFAULT NULL, `k2_col` int(11) DEFAULT NULL, `app_col` text COLLATE utf8mb4_general_ci, `app_col1` int(11) DEFAULT NULL, PRIMARY KEY (`col_to_drop`), UNIQUE KEY `k1` (`k1_col`), KEY `k2` (`k2_col`), KEY `vis_key` (`c1`), KEY `inv_key` (`c2`) /*!80000 INVISIBLE */, CONSTRAINT `old_chk1` CHECK ((`chk_col` < 100)), CONSTRAINT `old_chk2` CHECK ((`chk_col` > 10)) ) ENGINE=XENGINE DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci ####### # Inplace without rebuild ####### ALTER TABLE tt ALTER INDEX vis_key INVISIBLE, ALTER INDEX inv_key VISIBLE, ALGORITHM = INPLACE; ERROR 0A000: ALGORITHM=INPLACE is not supported for this operation. Try ALGORITHM=COPY. ALTER TABLE tt DROP KEY k1, DROP KEY k2, ADD INDEX key1(c4) COMMENT 'secondary key1', ADD UNIQUE INDEX key2(c3) COMMENT 'unique secondary key2', MODIFY COLUMN col_to_extend VARCHAR(100), RENAME COLUMN col_to_drop to col_to_drop_later, RENAME INDEX vis_key TO iv_key, RENAME INDEX inv_key TO v_key, ALGORITHM = INPLACE; ERROR 0A000: ALGORITHM=INPLACE is not supported for this operation. Try ALGORITHM=COPY. SHOW CREATE TABLE tt; Table Create Table tt CREATE TABLE `tt` ( `id` int(11) NOT NULL, `col_to_drop` int(11) NOT NULL, `c1` int(11), `c2` varchar(70) COLLATE utf8mb4_general_ci DEFAULT 'aaaa', `col_to_extend` varchar(70) COLLATE utf8mb4_general_ci DEFAULT NULL, `c3` int(11) NOT NULL, `c4` int(11) DEFAULT NULL, `chk_col` int(11) DEFAULT NULL, `k1_col` int(11) DEFAULT NULL, `k2_col` int(11) DEFAULT NULL, `app_col` text COLLATE utf8mb4_general_ci, `app_col1` int(11) DEFAULT NULL, PRIMARY KEY (`col_to_drop`), UNIQUE KEY `k1` (`k1_col`), KEY `k2` (`k2_col`), KEY `vis_key` (`c1`), KEY `inv_key` (`c2`) /*!80000 INVISIBLE */, CONSTRAINT `old_chk1` CHECK ((`chk_col` < 100)), CONSTRAINT `old_chk2` CHECK ((`chk_col` > 10)) ) ENGINE=XENGINE DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci ALTER TABLE tt DROP KEY k1, DROP KEY k2, ADD INDEX key1(c4) COMMENT 'secondary key1', ADD UNIQUE INDEX key2(c3) COMMENT 'unique secondary key2', MODIFY COLUMN col_to_extend VARCHAR(100), RENAME COLUMN col_to_drop to col_to_drop_later, RENAME INDEX vis_key TO iv_key, RENAME INDEX inv_key TO v_key, ALGORITHM = COPY; SHOW CREATE TABLE tt; Table Create Table tt CREATE TABLE `tt` ( `id` int(11) NOT NULL, `col_to_drop_later` int(11) NOT NULL, `c1` int(11), `c2` varchar(70) COLLATE utf8mb4_general_ci DEFAULT 'aaaa', `col_to_extend` varchar(100) COLLATE utf8mb4_general_ci DEFAULT NULL, `c3` int(11) NOT NULL, `c4` int(11) DEFAULT NULL, `chk_col` int(11) DEFAULT NULL, `k1_col` int(11) DEFAULT NULL, `k2_col` int(11) DEFAULT NULL, `app_col` text COLLATE utf8mb4_general_ci, `app_col1` int(11) DEFAULT NULL, PRIMARY KEY (`col_to_drop_later`), UNIQUE KEY `key2` (`c3`) COMMENT 'unique secondary key2', KEY `iv_key` (`c1`), KEY `v_key` (`c2`) /*!80000 INVISIBLE */, KEY `key1` (`c4`) COMMENT 'secondary key1', CONSTRAINT `old_chk1` CHECK ((`chk_col` < 100)), CONSTRAINT `old_chk2` CHECK ((`chk_col` > 10)) ) ENGINE=XENGINE DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci drop table tt; ######################################################################## case 1 INSTANT DDL + INPLACE DDL ######################################################################## CREATE TABLE t1(id INT PRIMARY KEY, c1 INT DEFAULT 1, c2 CHAR(10), KEY sk1(c2(6))) ENGINE=XENGINE; INSERT INTO t1 VALUES(1, 1, 'aaaa'), (2, 2, 'bbbb'); ALTER TABLE t1 ADD COLUMN c3 VARCHAR(30), ALGORITHM=INSTANT; SHOW CREATE TABLE t1; Table Create Table t1 CREATE TABLE `t1` ( `id` int(11) NOT NULL, `c1` int(11) DEFAULT '1', `c2` char(10) COLLATE utf8mb4_general_ci DEFAULT NULL, `c3` varchar(30) COLLATE utf8mb4_general_ci DEFAULT NULL, PRIMARY KEY (`id`), KEY `sk1` (`c2`(6)) ) ENGINE=XENGINE DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci ALTER TABLE t1 ADD COLUMN c4 FLOAT, ADD UNIQUE KEY uk(c1), ADD KEY sk(c3), DROP KEY sk1, ALGORITHM=INPLACE; ERROR 0A000: ALGORITHM=INPLACE is not supported for this operation. Try ALGORITHM=COPY. SHOW CREATE TABLE t1; Table Create Table t1 CREATE TABLE `t1` ( `id` int(11) NOT NULL, `c1` int(11) DEFAULT '1', `c2` char(10) COLLATE utf8mb4_general_ci DEFAULT NULL, `c3` varchar(30) COLLATE utf8mb4_general_ci DEFAULT NULL, PRIMARY KEY (`id`), KEY `sk1` (`c2`(6)) ) ENGINE=XENGINE DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci ALTER TABLE t1 ADD COLUMN c4 FLOAT, ADD UNIQUE KEY uk(c1), ADD KEY sk(c3), DROP KEY sk1, ALGORITHM=COPY; SHOW CREATE TABLE t1; Table Create Table t1 CREATE TABLE `t1` ( `id` int(11) NOT NULL, `c1` int(11) DEFAULT '1', `c2` char(10) COLLATE utf8mb4_general_ci DEFAULT NULL, `c3` varchar(30) COLLATE utf8mb4_general_ci DEFAULT NULL, `c4` float DEFAULT NULL, PRIMARY KEY (`id`), UNIQUE KEY `uk` (`c1`), KEY `sk` (`c3`) ) ENGINE=XENGINE DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci DROP TABLE t1; ######################################################################## case 2 INSTANT DDL + INPLACE REBUILD DDL ######################################################################## CREATE TABLE t1(id INT PRIMARY KEY, c1 INT DEFAULT 1, c2 CHAR(10), KEY sk1(c2(6))) ENGINE=XENGINE; INSERT INTO t1 VALUES(1, 1, 'aaaa'), (2, 2, 'bbbb'); ALTER TABLE t1 ADD COLUMN c3 VARCHAR(30), ALGORITHM=INSTANT; SHOW CREATE TABLE t1; Table Create Table t1 CREATE TABLE `t1` ( `id` int(11) NOT NULL, `c1` int(11) DEFAULT '1', `c2` char(10) COLLATE utf8mb4_general_ci DEFAULT NULL, `c3` varchar(30) COLLATE utf8mb4_general_ci DEFAULT NULL, PRIMARY KEY (`id`), KEY `sk1` (`c2`(6)) ) ENGINE=XENGINE DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci ALTER TABLE t1 ADD COLUMN c4 FLOAT, DROP COLUMN c1, ALGORITHM=INPLACE; ERROR 0A000: ALGORITHM=INPLACE is not supported for this operation. Try ALGORITHM=COPY. SHOW CREATE TABLE t1; Table Create Table t1 CREATE TABLE `t1` ( `id` int(11) NOT NULL, `c1` int(11) DEFAULT '1', `c2` char(10) COLLATE utf8mb4_general_ci DEFAULT NULL, `c3` varchar(30) COLLATE utf8mb4_general_ci DEFAULT NULL, PRIMARY KEY (`id`), KEY `sk1` (`c2`(6)) ) ENGINE=XENGINE DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci DROP TABLE t1; ######################################################################## case 3 INPLACE DDL + INPLACE REBUILD DDL ######################################################################## CREATE TABLE t1(id INT PRIMARY KEY, c1 INT DEFAULT 1, c2 CHAR(10), KEY sk1(c2(6))) ENGINE=XENGINE; INSERT INTO t1 VALUES(1, 1, 'aaaa'), (2, 2, 'bbbb'); ALTER TABLE t1 DROP COLUMN c2, ADD UNIQUE KEY uk(c1), ALGORITHM=INPLACE; ERROR 0A000: ALGORITHM=INPLACE is not supported for this operation. Try ALGORITHM=COPY. SHOW CREATE TABLE t1; Table Create Table t1 CREATE TABLE `t1` ( `id` int(11) NOT NULL, `c1` int(11) DEFAULT '1', `c2` char(10) COLLATE utf8mb4_general_ci DEFAULT NULL, PRIMARY KEY (`id`), KEY `sk1` (`c2`(6)) ) ENGINE=XENGINE DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci DROP TABLE t1; ######################################################################## case 4 INSTANT DDL + INPLACE DDL + INPLACE REBUILD DDL ######################################################################## CREATE TABLE t1(id INT PRIMARY KEY, c1 INT DEFAULT 1, c2 CHAR(10), KEY sk1(c2(6))) ENGINE=XENGINE; INSERT INTO t1 VALUES(1, 1, 'aaaa'), (2, 2, 'bbbb'); ALTER TABLE t1 ADD COLUMN c3 FLOAT, ADD UNIQUE KEY uk(c1), DROP COLUMN c2, ALGORITHM=INPLACE; ERROR 0A000: ALGORITHM=INPLACE is not supported for this operation. Try ALGORITHM=COPY. SHOW CREATE TABLE t1; Table Create Table t1 CREATE TABLE `t1` ( `id` int(11) NOT NULL, `c1` int(11) DEFAULT '1', `c2` char(10) COLLATE utf8mb4_general_ci DEFAULT NULL, PRIMARY KEY (`id`), KEY `sk1` (`c2`(6)) ) ENGINE=XENGINE DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci DROP TABLE t1; set global xengine_disable_online_ddl = @xengine_disable_online_ddl_saved; show variables like 'xengine_disable_online_ddl'; Variable_name Value xengine_disable_online_ddl 0