インデックスを追加

ALTER TABLE.. ADD INDEX文は既存のテーブルにインデックスを追加します。この操作は TiDB ではオンラインで実行されるため、インデックスの追加によってテーブルへの読み取りも書き込みもブロックされることはありません。

ヒント：
TiDB 分散実行フレームワーク (DXF)使用すると、このステートメントの操作を高速化できます。

警告

クラスター内で DDL ステートメントが実行されているときは、TiDB クラスターをアップグレードしないでください(通常は、 ADD INDEXや列タイプの変更などの時間のかかる DDL ステートメントの場合)。
アップグレード前に、 ADMIN SHOW DDLコマンドを使用して、TiDB クラスターで実行中の DDL ジョブがあるかどうかを確認することをお勧めします。クラスターに DDL ジョブがある場合は、クラスターをアップグレードする前に、DDL の実行が完了するまで待つか、 ADMIN CANCEL DDLコマンドを使用して DDL ジョブをキャンセルしてください。
また、クラスタのアップグレード中は、DDL文を実行しないでください。そうしないと、未定義の動作が発生する可能性があります。

TiDBをv7.1.0からそれ以降のバージョンにアップグレードする場合、上記の制限は無視できます。詳細については、 TiDBスムーズアップグレードの制限参照してください。

概要

AlterTableStmt
AddIndexSpec
IndexPartSpecification
IndexOption
IndexType

AlterTableStmt
         ::= 'ALTER' 'IGNORE'? 'TABLE' TableName AddIndexSpec ( ',' AddIndexSpec )*

AddIndexSpec
         ::= 'ADD' ( ( 'PRIMARY' 'KEY' | ( 'KEY' | 'INDEX' ) 'IF NOT EXISTS'? | 'UNIQUE' ( 'KEY' | 'INDEX' )? ) ( ( Identifier? 'USING' | Identifier 'TYPE' ) IndexType )? | 'FULLTEXT' ( 'KEY' | 'INDEX' )? IndexName ) '(' IndexPartSpecification ( ',' IndexPartSpecification )* ')' IndexOption*

IndexPartSpecification
         ::= ( ColumnName ( '(' LengthNum ')' )? | '(' Expression ')' ) ( 'ASC' | 'DESC' )

IndexOption
         ::= 'KEY_BLOCK_SIZE' '='? LengthNum
           | 'USING' IndexType
           | 'WITH' 'PARSER' Identifier
           | 'COMMENT' stringLit
           | 'VISIBLE'
           | 'INVISIBLE'
           | 'GLOBAL'
           | 'LOCAL'

IndexType
         ::= 'BTREE'
           | 'HASH'
           | 'RTREE'

例

mysql> CREATE TABLE t1 (id INT NOT NULL PRIMARY KEY AUTO_INCREMENT, c1 INT NOT NULL);
Query OK, 0 rows affected (0.11 sec)

mysql> INSERT INTO t1 (c1) VALUES (1),(2),(3),(4),(5);
Query OK, 5 rows affected (0.03 sec)
Records: 5  Duplicates: 0  Warnings: 0

mysql> 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)

mysql> ALTER TABLE t1 ADD INDEX (c1);
Query OK, 0 rows affected (0.30 sec)

mysql> EXPLAIN SELECT * FROM t1 WHERE c1 = 3;
+------------------------+---------+-----------+------------------------+---------------------------------------------+
| id                     | estRows | task      | access object          | operator info                               |
+------------------------+---------+-----------+------------------------+---------------------------------------------+
| IndexReader_6          | 0.01    | root      |                        | index:IndexRangeScan_5                      |
| └─IndexRangeScan_5     | 0.01    | cop[tikv] | table:t1, index:c1(c1) | range:[3,3], keep order:false, stats:pseudo |
+------------------------+---------+-----------+------------------------+---------------------------------------------+
2 rows in set (0.00 sec)

MySQLの互換性

TiDB はRTREE BTREE HASHインデックスタイプを受け入れますが、それらを無視します。
SPATIALインデックスはサポートされていません。
TiDB Self-Managed およびTiDB Cloud Dedicated は、 FULLTEXT構文の解析をサポートしますが、 FULLTEXTインデックスの使用はサポートしません。
注記：
現在、特定の AWS リージョンの {{{ .starter }} および {{{ .essential }}} クラスターのみがFULLTEXT構文とインデックスサポートしています。
降順インデックスはサポートされていません ( MySQL 5.7と同様)。
CLUSTERED型の主キーをテーブルに追加することはサポートされていません。3 型の主キーの詳細については、 CLUSTERED クラスター化インデックス参照してください。
GLOBALインデックスオプションを使用してPRIMARY KEYまたはUNIQUE INDEX グローバルインデックスとして設定することは、パーティションテーブルの TiDB 拡張であり、MySQL とは互換性がありません。

インデックスを追加

概要

例

MySQLの互換性

参照

このページは役に立ちましたか？