1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
|
# Scenario 1 : Rename a column
CREATE TABLE t1 (c1 INT, c2 INT, c3 INT AS (c1 + 10) VIRTUAL);
INSERT INTO t1(c1, c2) VALUES (1,11);
INSERT INTO t1(c1, c2) VALUES (2,22);
INSERT INTO t1(c1, c2) VALUES (3,33);
INSERT INTO t1(c1, c2) VALUES (4,44);
INSERT INTO t1(c1, c2) VALUES (5,55);
SELECT * FROM t1;
c1 c2 c3
1 11 11
2 22 12
3 33 13
4 44 14
5 55 15
ALTER TABLE t1 RENAME COLUMN c2 TO c22, ALGORITHM=INSTANT;
SELECT * FROM t1;
c1 c22 c3
1 11 11
2 22 12
3 33 13
4 44 14
5 55 15
CREATE TABLE tpart (c1 INT, c2 INT, c3 INT AS (c1 + 10) VIRTUAL)
PARTITION BY RANGE (c1) (
PARTITION tpart1 VALUES LESS THAN (10),
PARTITION tpart2 VALUES LESS THAN (100));
ALTER TABLE tpart RENAME COLUMN c1 TO c22, ALGORITHM=INSTANT;
ERROR HY000: Column 'c1' has a generated column dependency.
ALTER TABLE tpart RENAME COLUMN c2 TO c22, ALGORITHM=INSTANT;
# Scenario 2 : Rename an INSTANT ADD column
ALTER TABLE t1 ADD COLUMN c4 INT, ALGORITHM=INSTANT;
ALTER TABLE t1 RENAME COLUMN c4 to c44, ALGORITHM=INSTANT;
SELECT * FROM t1;
c1 c22 c3 c44
1 11 11 NULL
2 22 12 NULL
3 33 13 NULL
4 44 14 NULL
5 55 15 NULL
ALTER TABLE tpart ADD COLUMN c4 INT, ALGORITHM=INSTANT;
ALTER TABLE tpart RENAME COLUMN c4 TO c44, ALGORITHM=INSTANT;
SELECT * FROM tpart;
c1 c22 c3 c44
# Scenario 3 : Rename a VIRTUAL column
ALTER TABLE t1 CHANGE c3 c33 INT GENERATED ALWAYS AS (c1 + 10) VIRTUAL, algorithm=instant;
SELECT * FROM t1;
c1 c22 c33 c44
1 11 11 NULL
2 22 12 NULL
3 33 13 NULL
4 44 14 NULL
5 55 15 NULL
ALTER TABLE tpart CHANGE c3 c33 INT GENERATED ALWAYS AS (c1 + 10) VIRTUAL, ALGORITHM=INSTANT;
SELECT * FROM tpart;
c1 c22 c33 c44
# Scenario 4 : Rename an INSTANT ADD VIRTUAL column
ALTER TABLE t1 add COLUMN (c5 INT GENERATED ALWAYS AS (c1 + 10) VIRTUAL), ALGORITHM=INSTANT;
SELECT * FROM t1;
c1 c22 c33 c44 c5
1 11 11 NULL 11
2 22 12 NULL 12
3 33 13 NULL 13
4 44 14 NULL 14
5 55 15 NULL 15
ALTER TABLE t1 change c5 c55 INT GENERATED ALWAYS AS (c1 + 10) VIRTUAL, algorithm=instant;
SELECT * FROM t1;
c1 c22 c33 c44 c55
1 11 11 NULL 11
2 22 12 NULL 12
3 33 13 NULL 13
4 44 14 NULL 14
5 55 15 NULL 15
ALTER TABLE tpart ADD COLUMN (c5 INT GENERATED ALWAYS AS (c1 + 10) VIRTUAL), ALGORITHM=INSTANT;
SELECT * FROM tpart;
c1 c22 c33 c44 c5
ALTER TABLE tpart CHANGE c5 c55 INT GENERATED ALWAYS AS (c1 + 10) VIRTUAL, ALGORITHM=INSTANT;
SELECT * FROM tpart;
c1 c22 c33 c44 c55
DROP TABLE t1;
DROP TABLE tpart;
# Scenario 5 : Try to rename a column which is referenced in other table
# Case 1: Single column foreign key without unique index
CREATE TABLE t1 (c1 INT PRIMARY KEY, c2 INT, c3 INT, INDEX(c2));
CREATE TABLE t1c (c1 INT PRIMARY KEY, c2 INT,
CONSTRAINT t1c1 FOREIGN KEY (c2) REFERENCES t1(c2));
ALTER TABLE t1 CHANGE c2 c22 INT, algorithm=INSTANT;
ERROR 0A000: ALGORITHM=INSTANT is not supported. Reason: Columns participating in a foreign key are renamed. Try ALGORITHM=INPLACE.
SHOW CREATE TABLE t1;
Table Create Table
t1 CREATE TABLE `t1` (
`c1` int NOT NULL,
`c2` int DEFAULT NULL,
`c3` int DEFAULT NULL,
PRIMARY KEY (`c1`),
KEY `c2` (`c2`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci
SHOW CREATE TABLE t1c;
Table Create Table
t1c CREATE TABLE `t1c` (
`c1` int NOT NULL,
`c2` int DEFAULT NULL,
PRIMARY KEY (`c1`),
KEY `t1c1` (`c2`),
CONSTRAINT `t1c1` FOREIGN KEY (`c2`) REFERENCES `t1` (`c2`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci
ALTER TABLE t1 CHANGE c2 c22 INT;
SHOW CREATE TABLE t1;
Table Create Table
t1 CREATE TABLE `t1` (
`c1` int NOT NULL,
`c22` int DEFAULT NULL,
`c3` int DEFAULT NULL,
PRIMARY KEY (`c1`),
KEY `c2` (`c22`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci
SHOW CREATE TABLE t1c;
Table Create Table
t1c CREATE TABLE `t1c` (
`c1` int NOT NULL,
`c2` int DEFAULT NULL,
PRIMARY KEY (`c1`),
KEY `t1c1` (`c2`),
CONSTRAINT `t1c1` FOREIGN KEY (`c2`) REFERENCES `t1` (`c22`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci
DROP TABLE t1c;
DROP TABLE t1;
# Case 2: Single column foreign key with unique index
CREATE TABLE t1 (c1 INT, c2 INT, c3 INT NOT NULL, UNIQUE INDEX (c3));
CREATE TABLE t1c (c1 INT, c2 INT, c3 INT NOT NULL,
CONSTRAINT fk1 FOREIGN KEY (c3) REFERENCES t1(c3));
ALTER TABLE t1 CHANGE c3 c33 INT NOT NULL, ALGORITHM=INSTANT;
ERROR 0A000: ALGORITHM=INSTANT is not supported. Reason: Columns participating in a foreign key are renamed. Try ALGORITHM=INPLACE.
SHOW CREATE TABLE t1;
Table Create Table
t1 CREATE TABLE `t1` (
`c1` int DEFAULT NULL,
`c2` int DEFAULT NULL,
`c3` int NOT NULL,
UNIQUE KEY `c3` (`c3`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci
SHOW CREATE TABLE t1c;
Table Create Table
t1c CREATE TABLE `t1c` (
`c1` int DEFAULT NULL,
`c2` int DEFAULT NULL,
`c3` int NOT NULL,
KEY `fk1` (`c3`),
CONSTRAINT `fk1` FOREIGN KEY (`c3`) REFERENCES `t1` (`c3`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci
ALTER TABLE t1 CHANGE c3 c33 INT NOT NULL;
SHOW CREATE TABLE t1;
Table Create Table
t1 CREATE TABLE `t1` (
`c1` int DEFAULT NULL,
`c2` int DEFAULT NULL,
`c33` int NOT NULL,
UNIQUE KEY `c3` (`c33`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci
SHOW CREATE TABLE t1c;
Table Create Table
t1c CREATE TABLE `t1c` (
`c1` int DEFAULT NULL,
`c2` int DEFAULT NULL,
`c3` int NOT NULL,
KEY `fk1` (`c3`),
CONSTRAINT `fk1` FOREIGN KEY (`c3`) REFERENCES `t1` (`c33`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci
DROP TABLE t1c;
DROP TABLE t1;
# Case 3: Multi column foreign key without unique index
CREATE TABLE t1 (c1 INT, c2 INT, c3 INT NOT NULL, INDEX(c2, c3));
CREATE TABLE t1c (c1 INT, c2 INT, c3 INT NOT NULL,
CONSTRAINT fk1 FOREIGN KEY (c2, c3) REFERENCES t1(c2, c3));
ALTER TABLE t1 CHANGE c3 c33 INT NOT NULL, ALGORITHM=INSTANT;
ERROR 0A000: ALGORITHM=INSTANT is not supported. Reason: Columns participating in a foreign key are renamed. Try ALGORITHM=INPLACE.
SHOW CREATE TABLE t1;
Table Create Table
t1 CREATE TABLE `t1` (
`c1` int DEFAULT NULL,
`c2` int DEFAULT NULL,
`c3` int NOT NULL,
KEY `c2` (`c2`,`c3`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci
SHOW CREATE TABLE t1c;
Table Create Table
t1c CREATE TABLE `t1c` (
`c1` int DEFAULT NULL,
`c2` int DEFAULT NULL,
`c3` int NOT NULL,
KEY `fk1` (`c2`,`c3`),
CONSTRAINT `fk1` FOREIGN KEY (`c2`, `c3`) REFERENCES `t1` (`c2`, `c3`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci
ALTER TABLE t1 CHANGE c3 c33 INT NOT NULL;
SHOW CREATE TABLE t1;
Table Create Table
t1 CREATE TABLE `t1` (
`c1` int DEFAULT NULL,
`c2` int DEFAULT NULL,
`c33` int NOT NULL,
KEY `c2` (`c2`,`c33`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci
SHOW CREATE TABLE t1c;
Table Create Table
t1c CREATE TABLE `t1c` (
`c1` int DEFAULT NULL,
`c2` int DEFAULT NULL,
`c3` int NOT NULL,
KEY `fk1` (`c2`,`c3`),
CONSTRAINT `fk1` FOREIGN KEY (`c2`, `c3`) REFERENCES `t1` (`c2`, `c33`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci
DROP TABLE t1c;
DROP TABLE t1;
# Case 4: Multi column foreign key with unique index
CREATE TABLE t1 (c1 INT, c2 INT, c3 INT NOT NULL, UNIQUE INDEX(c2, c3));
CREATE TABLE t1c (c1 INT, c2 INT, c3 INT NOT NULL,
CONSTRAINT fk1 FOREIGN KEY (c2, c3) REFERENCES t1(c2, c3));
ALTER TABLE t1 CHANGE c3 c33 INT NOT NULL, ALGORITHM=INSTANT;
ERROR 0A000: ALGORITHM=INSTANT is not supported. Reason: Columns participating in a foreign key are renamed. Try ALGORITHM=INPLACE.
SHOW CREATE TABLE t1;
Table Create Table
t1 CREATE TABLE `t1` (
`c1` int DEFAULT NULL,
`c2` int DEFAULT NULL,
`c3` int NOT NULL,
UNIQUE KEY `c2` (`c2`,`c3`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci
SHOW CREATE TABLE t1c;
Table Create Table
t1c CREATE TABLE `t1c` (
`c1` int DEFAULT NULL,
`c2` int DEFAULT NULL,
`c3` int NOT NULL,
KEY `fk1` (`c2`,`c3`),
CONSTRAINT `fk1` FOREIGN KEY (`c2`, `c3`) REFERENCES `t1` (`c2`, `c3`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci
ALTER TABLE t1 CHANGE c3 c33 INT NOT NULL;
SHOW CREATE TABLE t1;
Table Create Table
t1 CREATE TABLE `t1` (
`c1` int DEFAULT NULL,
`c2` int DEFAULT NULL,
`c33` int NOT NULL,
UNIQUE KEY `c2` (`c2`,`c33`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci
SHOW CREATE TABLE t1c;
Table Create Table
t1c CREATE TABLE `t1c` (
`c1` int DEFAULT NULL,
`c2` int DEFAULT NULL,
`c3` int NOT NULL,
KEY `fk1` (`c2`,`c3`),
CONSTRAINT `fk1` FOREIGN KEY (`c2`, `c3`) REFERENCES `t1` (`c2`, `c33`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci
DROP TABLE t1c;
DROP TABLE t1;
# Scenario 6: Try to change the column name in a table with discarded tablespace
CREATE TABLE t1 (c1 int, c2 INT as (c1+1) VIRTUAL);
SELECT TABLE_ID INTO @old_tid FROM INFORMATION_SCHEMA.INNODB_TABLES WHERE NAME LIKE "%t1%";
ALTER TABLE t1 DISCARD TABLESPACE;
SELECT TABLE_ID INTO @new_tid FROM INFORMATION_SCHEMA.INNODB_TABLES WHERE NAME LIKE "%t1%";
SELECT (@old_tid != @new_tid) as Table_Id_Changed;
Table_Id_Changed
1
ALTER TABLE t1 RENAME COLUMN c2 to c3, algorithm=instant;
Warnings:
Warning 1814 InnoDB: Tablespace has been discarded for table 't1'
ALTER TABLE t1 RENAME COLUMN c3 to c2, algorithm=instant;
Warnings:
Warning 1814 InnoDB: Tablespace has been discarded for table 't1'
Drop TABLE t1;
CREATE TABLE tpart (c1 INT, c2 INT AS (c1 + 1) VIRTUAL)
PARTITION BY RANGE(c1) (
PARTITION p1 VALUES LESS THAN (10),
PARTITION p2 VALUES LESS THAN (100));
SELECT max(TABLE_ID) INTO @old_tpid FROM INFORMATION_SCHEMA.INNODB_TABLES WHERE NAME LIKE "%tpart%";
ALTER TABLE tpart DISCARD TABLESPACE;
SELECT max(TABLE_ID) INTO @new_tpid FROM INFORMATION_SCHEMA.INNODB_TABLES WHERE NAME LIKE "%tpart%";
SELECT (@old_tpid != @new_tpid) AS Table_Id_Changed;
Table_Id_Changed
1
ALTER TABLE tpart RENAME COLUMN c2 TO c3, ALGORITHM=INSTANT;
Warnings:
Warning 1814 InnoDB: Tablespace has been discarded for table 'tpart'
Warning 1814 InnoDB: Tablespace has been discarded for table 'tpart'
ALTER TABLE tpart RENAME COLUMN c3 TO c2, ALGORITHM=INSTANT;
Warnings:
Warning 1814 InnoDB: Tablespace has been discarded for table 'tpart'
Warning 1814 InnoDB: Tablespace has been discarded for table 'tpart'
DROP TABLE tpart;
# Scenario 7: Try to rename a column to an internal column name
CREATE TABLE t1 (c1 INT, c2 INT);
ALTER TABLE t1 RENAME COLUMN c1 TO DB_ROW_ID;
ERROR 42000: Incorrect column name 'DB_ROW_ID'
ALTER TABLE t1 RENAME COLUMN c1 TO DB_TRX_ID;
ERROR 42000: Incorrect column name 'DB_TRX_ID'
ALTER TABLE t1 RENAME COLUMN c1 TO DB_ROLL_PTR;
ERROR 42000: Incorrect column name 'DB_ROLL_PTR'
DROP TABLE t1;
# Scenario 8: Rename SET and ENUM type columns
CREATE TABLE tenum (c1 INT, c2 ENUM('a','b'));
INSERT INTO tenum VALUES (1, 'a');
ALTER TABLE tenum RENAME COLUMN c2 TO c22, ALGORITHM=INSTANT;
ALTER TABLE tenum CHANGE c22 c2 ENUM ('a','b','c'), ALGORITHM=INSTANT;
ALTER TABLE tenum CHANGE c2 c22 ENUM ('a','b'), ALGORITHM=INSTANT;
ERROR 0A000: ALGORITHM=INSTANT is not supported. Reason: Need to rebuild the table to change column type. Try ALGORITHM=COPY/INPLACE.
DROP TABLE tenum;
CREATE TABLE tset (c1 INT, c2 SET('a','b'));
INSERT INTO tset VALUES (1, 'a');
ALTER TABLE tset RENAME COLUMN c2 TO c22, ALGORITHM=INSTANT;
ALTER TABLE tset CHANGE c22 c2 SET ('a','b','c'), ALGORITHM=INSTANT;
ALTER TABLE tset CHANGE c2 c22 SET ('a','b'), ALGORITHM=INSTANT;
ERROR 0A000: ALGORITHM=INSTANT is not supported. Reason: Need to rebuild the table to change column type. Try ALGORITHM=COPY/INPLACE.
DROP TABLE tset;
# Scenario 9: CHANGE column cannot use INSTANT algorithm if
# it involves definition change
CREATE TABLE tchange (c1 INT, c2 INT);
ALTER TABLE tchange CHANGE c2 c2 DOUBLE, ALGORITHM=INSTANT;
ERROR 0A000: ALGORITHM=INSTANT is not supported. Reason: Need to rebuild the table to change column type. Try ALGORITHM=COPY/INPLACE.
ALTER TABLE tchange CHANGE c2 c2 DOUBLE, ALGORITHM=INPLACE;
ERROR 0A000: ALGORITHM=INPLACE is not supported. Reason: Cannot change column type INPLACE. Try ALGORITHM=COPY.
ALTER TABLE tchange CHANGE c2 c22 DOUBLE, ALGORITHM=COPY;
SHOW CREATE TABLE tchange;
Table Create Table
tchange CREATE TABLE `tchange` (
`c1` int DEFAULT NULL,
`c22` double DEFAULT NULL
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci
ALTER TABLE tchange CHANGE c22 c2 DOUBLE, ALGORITHM=INSTANT;
SHOW CREATE TABLE tchange;
Table Create Table
tchange CREATE TABLE `tchange` (
`c1` int DEFAULT NULL,
`c2` double DEFAULT NULL
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci
DROP TABLE tchange;
# Scenario 10: INSTANT RENAME WITH INSTANT ADD
Create table t1 (c1 int KEY, c2 int, c3 int, c4 int);
desc t1;
Field Type Null Key Default Extra
c1 int NO PRI NULL
c2 int YES NULL
c3 int YES NULL
c4 int YES NULL
alter table t1 add column c5 int , rename column c2 to c22, algorithm=instant;
desc t1;
Field Type Null Key Default Extra
c1 int NO PRI NULL
c22 int YES NULL
c3 int YES NULL
c4 int YES NULL
c5 int YES NULL
alter table t1 add column v1 int as (c1+1), add column v2 int as (c1+2) virtual, rename column c3 to c33, algorithm=instant;
ERROR 0A000: ALGORITHM=INSTANT is not supported. Reason: INPLACE ADD or DROP of virtual columns cannot be combined with other ALTER TABLE actions. Try ALGORITHM=COPY/INPLACE.
alter table t1 add column v1 int as (c1+1), add column v2 int as (c1+2) virtual, algorithm=instant;
desc t1;
Field Type Null Key Default Extra
c1 int NO PRI NULL
c22 int YES NULL
c3 int YES NULL
c4 int YES NULL
c5 int YES NULL
v1 int YES NULL VIRTUAL GENERATED
v2 int YES NULL VIRTUAL GENERATED
alter table t1 drop column v1, algorithm=instant;
ERROR 0A000: ALGORITHM=INSTANT is not supported for this operation. Try ALGORITHM=COPY/INPLACE.
alter table t1 drop column v2, algorithm=instant;
desc t1;
Field Type Null Key Default Extra
c1 int NO PRI NULL
c22 int YES NULL
c3 int YES NULL
c4 int YES NULL
c5 int YES NULL
v1 int YES NULL VIRTUAL GENERATED
alter table t1 drop column v1, rename column c22 to c222, algorithm=instant;
ERROR 0A000: ALGORITHM=INSTANT is not supported. Reason: INPLACE ADD or DROP of virtual columns cannot be combined with other ALTER TABLE actions. Try ALGORITHM=COPY/INPLACE.
DROP TABLE t1;
|
