13.1.7. ALTER TABLE Синтаксис

Для ALTER TABLE tbl_name RENAME TO new_tbl_name без любых других опций MySQL просто переименовывает любые файлы, которые соответствуют таблице tbl_name не делая копию. (Можно также использовать RENAME TABLE оператор, чтобы переименовать таблицы. См. Раздел 13.1.32,"RENAME TABLE Синтаксис".) Любые полномочия, предоставленные определенно для переименованной таблицы, не перемещаются на новое имя. Они должны быть изменены вручную.

Изменения, которые изменяют только табличные метаданные и не табличные данные, могут быть сразу сделаны, изменяя таблицу .frm файл и не затрагивающее табличное содержание. Следующие изменения являются быстрыми изменениями, которые могут быть пробиты:

ALTER TABLE с ADD PARTITION, DROP PARTITION, COALESCE PARTITION, REBUILD PARTITION, или REORGANIZE PARTITION не создает временных таблиц (кроме тех случаев, когда используемый с NDB таблицы); однако, эти операции могут и действительно создавать временные файлы раздела.

ADD или DROP операции для RANGE или LIST разделы являются непосредственными операциями или почти так. ADD или COALESCE операции для HASH или KEY разделы не копируют данные между всеми разделами, если LINEAR HASH или LINEAR KEY использовался; это - эффективно то же самое как составление новой таблицы, хотя ADD или COALESCE работа является выполняемым разделом разделом. REORGANIZE операции копируют только измененные разделы и не касаются неизменных.

Переименование индексирования, за исключением InnoDB.

Добавление или отбрасывание индексирования, для InnoDB и NDB.

LOCK = DEFAULT

LOCK = NONE

LOCK = SHARED

LOCK = EXCLUSIVE

Использовать ALTER TABLE, Вы нуждаетесь ALTER, CREATE, и INSERT полномочия для таблицы. Переименование таблицы требует ALTER и DROP на старой таблице, ALTER, CREATE, и INSERT на новой таблице.

IGNORE расширение MySQL стандартного SQL. Это управляет как ALTER TABLE работы, если есть копии на уникальных ключах в новой таблице или если предупреждения происходят, когда строгий режим включается. Если IGNORE не определяется, копия прерывается и откатывается, если двойные ключевые ошибки происходят. Если IGNORE определяется, только первая строка используется строк с копиями на уникальном ключе. Другие конфликтные строки удаляются. Неправильные значения являются усеченными к самому близкому соответствующему приемлемому значению.

Ожидание INSERT DELAYED операторы теряются, если таблица является заблокированной записью и ALTER TABLE используется, чтобы изменить структуру таблицы.

table_option показывает табличную опцию вида, который может использоваться в CREATE TABLE оператор, такой как ENGINE, AUTO_INCREMENT, AVG_ROW_LENGTH, или MAX_ROWS. Для списка всех табличных опций и описаний каждого, см. Раздел 13.1.17,"CREATE TABLE Синтаксис". Однако, ALTER TABLE игнорирует DATA DIRECTORY и INDEX DIRECTORY табличные опции.

Например, чтобы преобразовать таблицу, чтобы быть InnoDB таблица, используйте этот оператор:

ALTER TABLE t1 ENGINE = InnoDB;

См. Раздел 5.4.3, "Преобразовывая Таблицы из MyISAM к InnoDB"для соображений, переключая таблицы на InnoDB механизм хранения.

Когда Вы определяете ENGINE пункт, ALTER TABLE восстанавливает таблицу. Это - истина, даже если у таблицы уже есть указанный механизм хранения.

На результат попытки изменить механизм хранения таблицы влияют тем, доступен ли требуемый механизм хранения и установка NO_ENGINE_SUBSTITUTION Режим SQL, как описано в Разделе 5.1.7, "Режимы SQL Сервера".

Предотвратить непреднамеренную потерю данных, ALTER TABLE не может использоваться, чтобы изменить механизм хранения таблицы к MERGE или BLACKHOLE.

Изменить значение AUTO_INCREMENT в противоречии с использоваться для новых строк, сделайте это:

ALTER TABLE t2 AUTO_INCREMENT = value;

Невозможно сбросить в противоречии со значением, меньше чем или равным никому, которые уже использовались. Для MyISAM, если значение меньше чем или равно максимальному значению в настоящий момент в AUTO_INCREMENT столбец, значение сбрасывается к текущему максимуму плюс один. Для InnoDB, если значение является меньше чем текущее максимальное значение в столбце, никакая ошибка не происходит, и текущее значение последовательности не изменяется.

Можно выйти многократный ADD, ALTER, DROP, и CHANGE пункты в сингле ALTER TABLE оператор, разделенный запятыми. Это - расширение MySQL стандартного SQL, который разрешает только один из каждого пункта на ALTER TABLE оператор. Например, чтобы отбросить многократные столбцы в единственном операторе, сделайте это:

ALTER TABLE t2 DROP COLUMN c, DROP COLUMN d;

CHANGE col_name, DROP col_name, и DROP INDEX расширения MySQL стандартного SQL.

Слово COLUMN является дополнительным и может быть опущен.

column_definition пункты используют тот же самый синтаксис для ADD и CHANGE что касается CREATE TABLE. См. Раздел 13.1.17,"CREATE TABLE Синтаксис".

Можно переименовать столбец, используя a CHANGE old_col_name new_col_name column_definition пункт. Чтобы сделать так, определите старые и новые имена столбцов и определение, которое в настоящий момент имеет столбец. Например, чтобы переименовать INTEGER столбец от a к b, можно сделать это:

ALTER TABLE t1 CHANGE a b INTEGER;

Изменить тип столбца, но не имя, CHANGE синтаксис все еще требует старого и нового имени столбца, даже если они - то же самое. Например:

ALTER TABLE t1 CHANGE b b BIGINT NOT NULL;

Можно также использовать MODIFY изменить тип столбца, не переименовывая это:

ALTER TABLE t1 MODIFY b BIGINT NOT NULL;

MODIFY расширение ALTER TABLE для совместимости Oracle.

Когда Вы используете CHANGE или MODIFY, column_definition должен включать тип данных и все атрибуты, которые должны примениться к новому столбцу, кроме индексируют атрибуты такой как PRIMARY KEY или UNIQUE. Атрибуты, существующие в исходном определении, но не определенный для нового определения, не продвигаются. Предположите что столбец col1 определяется как INT UNSIGNED DEFAULT 1 COMMENT 'my column' и Вы изменяете столбец следующим образом:

ALTER TABLE t1 MODIFY col1 BIGINT;

Получающийся столбец будет определен как BIGINT, но не будет включать атрибуты UNSIGNED DEFAULT 1 COMMENT 'my column'. Чтобы сохранить их, оператор должен быть:

ALTER TABLE t1 MODIFY col1 BIGINT UNSIGNED DEFAULT 1 COMMENT 'my column';

Когда Вы изменяете использование типа данных CHANGE или MODIFY, MySQL пытается преобразовать существующие значения столбцов в новый тип так же как возможный.

Чтобы добавить столбец в определенной позиции в пределах строки таблицы, использовать FIRST или AFTER col_name. Значение по умолчанию должно добавить последний столбец. Можно также использовать FIRST и AFTER в CHANGE или MODIFY операции, чтобы переупорядочить столбцы в пределах таблицы.

ALTER ... SET DEFAULT или ALTER ... DROP DEFAULT определите новое значение по умолчанию для столбца или удалите старое значение по умолчанию, соответственно. Если старое значение по умолчанию удаляется, и столбец может быть NULL, новое значение по умолчанию NULL. Если столбец не может быть NULL, MySQL присваивает значение по умолчанию как описано в Разделе 11.5, "Значения по умолчанию Типа данных".

DROP INDEX удаляет индексирование. Это - расширение MySQL стандартного SQL. См. Раздел 13.1.24,"DROP INDEX Синтаксис". Если Вы неуверены в имени индекса, использовать SHOW INDEX FROM tbl_name.

Если столбцы отбрасываются от таблицы, столбцы также удаляются от любого, индексируют, из которых они - часть. Если все столбцы, которые составляют индексирование, отбрасываются, индексирование отбрасывается также. Если Вы используете CHANGE или MODIFY чтобы сократить столбец, для которого индексирование существует на столбце, и получающаяся длина столбца является меньше чем индексировать длина, MySQL сокращает индексирование автоматически.

Если таблица содержит только один столбец, столбец не может быть отброшен. Если то, что Вы предназначаете, должно удалить таблицу, использовать DROP TABLE вместо этого.

DROP PRIMARY KEY отбрасывает первичный ключ. Если нет никакого первичного ключа, ошибка происходит. Для получения информации о показателях производительности первичных ключей, специально для InnoDB таблицы, см. Раздел 8.3.2, "Используя Первичные ключи".

Если Вы добавляете a UNIQUE INDEX или PRIMARY KEY к таблице MySQL хранит это прежде, чем любой групповой индексирует, чтобы разрешить, чтобы обнаружение сделало дубликаты ключа как можно раньше.

Некоторые механизмы хранения разрешают Вам определять индексировать тип, создавая индексирование. Синтаксис для index_type спецификатор USING type_name. Для получения дополнительной информации о USING, см. Раздел 13.1.13,"CREATE INDEX Синтаксис". Привилегированная позиция после списка столбцов. Поддержка использования опции перед списком столбцов будет удалена в будущем выпуске MySQL.

index_option значения определяют дополнительные опции для индексирования. USING одна такая опция. Для получения дополнительной информации о допустимом index_option значения, см. Раздел 13.1.13,"CREATE INDEX Синтаксис".

После ALTER TABLE оператор, может быть необходимо работать ANALYZE TABLE чтобы обновить индексируют информацию о количестве элементов. См. Раздел 13.7.5.23,"SHOW INDEX Синтаксис".

ORDER BY позволяет Вам составить новую таблицу со строками в определенном порядке. Отметьте, что таблица не остается в этом порядке после того, как вставляет и удаляет. Эта опция полезна прежде всего, когда Вы знаете, что должны главным образом запросить строки в определенном порядке большую часть времени. При использовании этой опции после существенных изменений к таблице Вы могли бы быть в состоянии получить более высокую производительность. В некоторых случаях это могло бы сделать сортировку легче для MySQL, если таблица в порядке столбцом, которым Вы хотите упорядочить это позже.

ORDER BY синтаксис разрешает одному или более именам столбцов быть определенными для того, чтобы сортировать, каждый из которых дополнительно может сопровождаться ASC или DESC указать на сортировку по возрастанию или сортировку по убыванию, соответственно. Значение по умолчанию является порядком по возрастанию. Только имена столбцов разрешаются как критерии сортировки; произвольные выражения не разрешаются. Этот пункт должен быть дан последний после любых других пунктов.

ORDER BY не имеет смысла для InnoDB таблицы, которые содержат определяемый пользователем кластерный индекс (PRIMARY KEY или NOT NULL UNIQUE индексируйте). InnoDB всегда строки таблицы "Заказы" согласно такому индексировать, если Вы присутствуете.

Если Вы используете ALTER TABLE на a MyISAM таблица, все групповые индексируют, создаются в отдельном пакете (что касается REPAIR TABLE). Это должно сделать ALTER TABLE намного быстрее, когда Вы имеете, многие индексируют.

Эта опция может быть активирована явно для a MyISAM таблица. ALTER TABLE ... DISABLE KEYS говорит, что MySQL, чтобы прекратить обновлять групповой индексирует. ALTER TABLE ... ENABLE KEYS тогда должен использоваться, чтобы воссоздать без вести пропавших, индексирует. MySQL делает это со специальным алгоритмом, который намного быстрее чем вставка ключей один за другим, таким образом, отключение ключей прежде, чем выполнить объемные операции вставки должно дать значительное ускорение. Используя ALTER TABLE ... DISABLE KEYS требует INDEX полномочие в дополнение к полномочиям, упомянутым ранее.

В то время как групповое индексирует, отключаются, они игнорируются для операторов такой как SELECT и EXPLAIN это иначе использовало бы их.

Перед MySQL 5.6.7, используя ALTER TABLE изменить определение столбца внешнего ключа могло вызвать потерю ссылочной целостности. Например, изменяя столбец внешнего ключа, который содержал NULL значения, чтобы быть NOT NULL вызванный NULL значения, чтобы быть пустой строкой. Точно так же ALTER TABLE IGNORE это удалило строки в родительской таблице, мог повредить ссылочную целостность.

С 5.6.7, сервер запрещает, что изменения к столбцам внешнего ключа с потенциалом вызывают потерю ссылочной целостности. Обходное решение должно использовать ALTER TABLE ... DROP FOREIGN KEY прежде, чем изменить определение столбца и ALTER TABLE ... ADD FOREIGN KEY позже.

FOREIGN KEY и REFERENCES пункты поддерживаются InnoDB и NDB механизмы хранения, которые реализуют ADD [CONSTRAINT [symbol]] FOREIGN KEY [index_name] (...) REFERENCES ... (...). См. Раздел 5.4.5,"InnoDB и FOREIGN KEY Ограничения". Для других механизмов хранения пункты анализируются, но игнорируются. CHECK пункт анализируется, но игнорируется всеми механизмами хранения. См. Раздел 13.1.17,"CREATE TABLE Синтаксис". Причина того, чтобы принять, но проигнорировать пункты синтаксиса для совместимости, чтобы облегчить портировать код от других SQL-серверов, и запускать приложения, которые составляют таблицы со ссылками. См. Раздел 1.8.5, "SQL MySQL Differences from Standard".

Для ALTER TABLE, в отличие от этого CREATE TABLE, ADD FOREIGN KEY игнорирует index_name если дано и использование автоматически сгенерированное имя внешнего ключа. Как обходное решение, включайте CONSTRAINT пункт, чтобы определить имя внешнего ключа:

ADD CONSTRAINT name FOREIGN KEY (....) ...

InnoDB и NDB механизмы хранения поддерживают использование ALTER TABLE отбрасывать внешние ключи:

ALTER TABLE tbl_name DROP FOREIGN KEY fk_symbol;

Для получения дополнительной информации см. Раздел 5.4.5,"InnoDB и FOREIGN KEY Ограничения".

Невозможно добавить внешний ключ и отбросить внешний ключ в отдельных пунктах сингла ALTER TABLE оператор. Следует использовать отдельные операторы.

Для InnoDB таблица, которая составляется с ее собственной табличной областью в .ibd файл, тот файл может быть отброшен и импортирован. Отбрасывать .ibd файл, используйте этот оператор:

ALTER TABLE tbl_name DISCARD TABLESPACE;

Это удаляет ток .ibd файл, так убедиться, что у Вас есть резервное копирование сначала. Попытка изменить табличное содержание, в то время как файл табличной области отбрасывается результаты по ошибке. Можно выполнить операции DDL, перечисленные в Разделе 5.5, "Онлайновый DDL для InnoDB Таблицы", в то время как файл табличной области отбрасывается.

Импортировать резервное копирование .ibd файл назад в таблицу, скопируйте это в каталог базы данных, и затем сделайте это заявление:

ALTER TABLE tbl_name IMPORT TABLESPACE;

Файл табличной области не должен обязательно быть создан на сервере, в который он импортируется позже. В MySQL 5.6, импортируя файл табличной области из другого сервера работает, если у обоих серверов есть GA (генерал Авэйлэблилити), состояние и их версии в пределах того же самого ряда. Иначе, файл, должно быть, был создан на сервере, в который он импортируется.

См. Раздел 5.4.1, "Управляя Табличными областями InnoDB".

Изменить табличный набор символов значения по умолчанию и все символьные столбцы (CHAR, VARCHAR, TEXT) к новому набору символов используйте оператор как это:

ALTER TABLE tbl_name CONVERT TO CHARACTER SET charset_name;

Для столбца, у которого есть тип данных VARCHAR или один из TEXT типы, CONVERT TO CHARACTER SET изменит тип данных по мере необходимости, чтобы гарантировать, что новый столбец достаточно длинен, чтобы сохранить так много символов как исходный столбец. Например, a TEXT у столбца есть два байта длины, которые хранят длиной до байта из значений в столбце до максимума 65 535. Для a latin1 TEXT столбец, каждый символ требует единственного байта, таким образом, столбец может сохранить до 65 535 символов. Если столбец преобразовывается в utf8, каждый символ мог бы потребовать до трех байтов для максимальной возможной длины 3 × 65 535 = 196 605 байтов. Та длина не будет помещаться в a TEXT байты длины столбца, таким образом, MySQL преобразует тип данных в MEDIUMTEXT, который является самым маленьким строковым типом, для которого байты длины могут записать значение 196 605. Точно так же a VARCHAR столбец мог бы быть преобразован в MEDIUMTEXT.

Чтобы избежать изменений типа данных типа, только описанного, не использовать CONVERT TO CHARACTER SET. Вместо этого используйте MODIFY изменить отдельные столбцы. Например:

ALTER TABLE t MODIFY latin1_text_col TEXT CHARACTER SET utf8;ALTER TABLE t MODIFY latin1_varchar_col VARCHAR(M) CHARACTER SET utf8;

Если Вы определяете CONVERT TO CHARACTER SET binary, CHAR, VARCHAR, и TEXT столбцы преобразовываются в их соответствующие типы двоичной строки (BINARY, VARBINARY, BLOB). Это означает, что у столбцов больше не будет набора символов и последующего CONVERT TO работа не будет применяться к ним.

Если charset_name DEFAULT, набор символов базы данных используется.

ALTER TABLE t1 CHANGE c1 c1 BLOB;ALTER TABLE t1 CHANGE c1 c1 TEXT CHARACTER SET utf8;

Чтобы изменить только набор символов значения по умолчанию для таблицы, используйте этот оператор:

ALTER TABLE tbl_name DEFAULT CHARACTER SET charset_name;

Слово DEFAULT является дополнительным. Набор символов значения по умолчанию является набором символов, который используется, если Вы не определяете набор символов для столбцов, которые Вы добавляете к таблице позже (например, с ALTER TABLE ... ADD column).