他の机

このステートメントは、新しいテーブル構造に準拠するように既存のテーブルを変更します。ステートメントALTER TABLEは、次の目的で使用できます。

あらすじ

AlterTableStmt
ALTERIgnoreOptionalTABLETableNameAlterTableSpecListOptAlterTablePartitionOptANALYZEPARTITIONPartitionNameListINDEXIndexNameListAnalyzeOptionListOptCOMPACTTIFLASHREPLICA
TableName
Identifier.Identifier
AlterTableSpec
TableOptionListSETTIFLASHREPLICALengthNumLocationLabelListCONVERTTOCharsetKwCharsetNameDEFAULTOptCollateADDColumnKeywordOptIfNotExistsColumnDefColumnPosition(TableElementList)ConstraintPARTITIONIfNotExistsNoWriteToBinLogAliasOptPartitionDefinitionListOptPARTITIONSNUMCHECKTRUNCATEPARTITIONOPTIMIZEREPAIRREBUILDPARTITIONNoWriteToBinLogAliasOptAllOrPartitionNameListCOALESCEPARTITIONNoWriteToBinLogAliasOptNUMDROPColumnKeywordOptIfExistsColumnNameRestrictOrCascadeOptPRIMARYKEYPARTITIONIfExistsPartitionNameListKeyOrIndexIfExistsCHECKIdentifierFOREIGNKEYIfExistsSymbolEXCHANGEPARTITIONIdentifierWITHTABLETableNameWithValidationOptIMPORTDISCARDPARTITIONAllOrPartitionNameListTABLESPACEREORGANIZEPARTITIONNoWriteToBinLogAliasOptReorganizePartitionRuleOptORDERBYAlterOrderItem,DISABLEENABLEKEYSMODIFYColumnKeywordOptIfExistsCHANGEColumnKeywordOptIfExistsColumnNameColumnDefColumnPositionALTERColumnKeywordOptColumnNameSETDEFAULTSignedLiteral(Expression)DROPDEFAULTCHECKIdentifierEnforcedOrNotINDEXIdentifierIndexInvisibleRENAMECOLUMNKeyOrIndexIdentifierTOIdentifierTO=ASTableNameLockClauseAlgorithmClauseFORCEWITHWITHOUTVALIDATIONSECONDARY_LOADSECONDARY_UNLOADAUTO_INCREMENTAUTO_ID_CACHEAUTO_RANDOM_BASESHARD_ROW_ID_BITSEqOptLengthNumCACHENOCACHE

初期データを含むテーブルを作成します。

CREATE TABLE t1 (id INT NOT NULL PRIMARY KEY AUTO_INCREMENT, c1 INT NOT NULL); INSERT INTO t1 (c1) VALUES (1),(2),(3),(4),(5);
Query OK, 0 rows affected (0.11 sec) Query OK, 5 rows affected (0.03 sec) Records: 5 Duplicates: 0 Warnings: 0

次のクエリでは、列 c1 にインデックスが付けられていないため、完全なテーブル スキャンが必要です。

EXPLAIN SELECT * FROM t1 WHERE c1 = 3;
+-------------------------+----------+-----------+---------------+--------------------------------+ | id | estRows | task | access object | operator info | +-------------------------+----------+-----------+---------------+--------------------------------+ | TableReader_7 | 10.00 | root | | data:Selection_6 | | └─Selection_6 | 10.00 | cop[tikv] | | eq(test.t1.c1, 3) | | └─TableFullScan_5 | 10000.00 | cop[tikv] | table:t1 | keep order:false, stats:pseudo | +-------------------------+----------+-----------+---------------+--------------------------------+ 3 rows in set (0.00 sec)

ステートメントALTER TABLE .. ADD INDEXを使用して、テーブル t1 にインデックスを追加できます。 EXPLAINは、元のクエリがより効率的なインデックス レンジ スキャンを使用するようになったことを確認します。

ALTER TABLE t1 ADD INDEX (c1); EXPLAIN SELECT * FROM t1 WHERE c1 = 3;
Query OK, 0 rows affected (0.30 sec) +------------------------+---------+-----------+------------------------+---------------------------------------------+ | id | estRows | task | access object | operator info | +------------------------+---------+-----------+------------------------+---------------------------------------------+ | IndexReader_6 | 10.00 | root | | index:IndexRangeScan_5 | | └─IndexRangeScan_5 | 10.00 | cop[tikv] | table:t1, index:c1(c1) | range:[3,3], keep order:false, stats:pseudo | +------------------------+---------+-----------+------------------------+---------------------------------------------+ 2 rows in set (0.00 sec)

TiDB は、DDL の変更が特定のALTERアルゴリズムを使用することをアサートする機能をサポートしています。これは単なるアサーションであり、テーブルの変更に使用される実際のアルゴリズムを変更するものではありません。クラスターのピーク時に即時の DDL 変更のみを許可する場合に役立ちます。

ALTER TABLE t1 DROP INDEX c1, ALGORITHM=INSTANT;
Query OK, 0 rows affected (0.24 sec)

INPLACEアルゴリズムを必要とする操作でALGORITHM=INSTANTアサーションを使用すると、ステートメント エラーが発生します。

ALTER TABLE t1 ADD INDEX (c1), ALGORITHM=INSTANT;
ERROR 1846 (0A000): ALGORITHM=INSTANT is not supported. Reason: Cannot alter table by INSTANT. Try ALGORITHM=INPLACE.

ただし、 INPLACE操作にALGORITHM=COPYアサーションを使用すると、エラーではなく警告が生成されます。これは、TiDB がアサーションをこのアルゴリズム以上のものとして解釈するためです。 TiDB が使用するアルゴリズムは MySQL とは異なる可能性があるため、この動作の違いは MySQL の互換性に役立ちます。

ALTER TABLE t1 ADD INDEX (c1), ALGORITHM=COPY; SHOW WARNINGS;
Query OK, 0 rows affected, 1 warning (0.25 sec) +-------+------+---------------------------------------------------------------------------------------------+ | Level | Code | Message | +-------+------+---------------------------------------------------------------------------------------------+ | Error | 1846 | ALGORITHM=COPY is not supported. Reason: Cannot alter table by COPY. Try ALGORITHM=INPLACE. | +-------+------+---------------------------------------------------------------------------------------------+ 1 row in set (0.00 sec)

MySQL の互換性

次の主要な制限が TiDB のALTER TABLEに適用されます。

  • 単一のALTER TABLEステートメントで複数のスキーマ オブジェクトを変更する場合:

    • 複数の変更で同じオブジェクトを変更することはサポートされていません。
    • TiDB は、実行前にテーブル スキーマに従ってステートメントを検証します。たとえば、インデックスiがテーブルに存在しないため、 ALTER TABLE ADD INDEX i(b), DROP INDEX i;を実行するとエラーが返されます。
    • ALTER TABLEステートメントの場合、TiDB での実行順序は左から右に次々と変更されます。これは、場合によっては MySQL と互換性がありません。
  • 主キー列の再編成データ型の変更はサポートされていません。

  • 分割されたテーブルでの列の型の変更はサポートされていません。

  • 生成された列の列タイプの変更はサポートされていません。

  • TiDB と MySQL 間のCAST関数の動作の互換性の問題により、一部のデータ型 (たとえば、一部の TIME、Bit、Set、Enum、および JSON 型) の変更はサポートされていません。

  • 空間データ型はサポートされていません。

  • ALTER TABLE t CACHE | NOCACHEは、MySQL 構文に対する TiDB 拡張です。詳細については、 キャッシュされたテーブルを参照してください。

その他の制限については、 MySQL の互換性を参照してください。

こちらもご覧ください