セカンダリインデックスを作成する

このドキュメントでは、SQL とさまざまなプログラミング言語を使用してセカンダリインデックスを作成する方法について説明し、インデックス作成の規則を示します。このドキュメントでは、書店のアプリケーションを例として、セカンダリインデックス作成の手順を説明します。

始める前に

セカンダリインデックスを作成する前に、次の操作を行います。

二次索引とは

セカンダリインデックスは、TiDB クラスター内の論理オブジェクトです。これは単に、TiDB がクエリのパフォーマンスを向上させるために使用するデータの並べ替えタイプと見なすことができます。 TiDB では、セカンダリインデックスの作成はオンライン操作であり、テーブルに対するデータの読み取りおよび書き込み操作をブロックしません。インデックスごとに、TiDB はテーブル内の各行の参照を作成し、直接データではなく選択した列で参照を並べ替えます。

副次索引について詳しくは、二次索引を参照してください。

TiDB では、セカンダリインデックスを既存のテーブルに追加するまたは新しいテーブルを作成するときにセカンダリインデックスを作成するのいずれかを使用できます。

既存のテーブルにセカンダリインデックスを追加する

セカンダリインデックスを既存のテーブルに追加するには、次のようにインデックスを作成ステートメントを使用できます。

CREATE INDEX {index_name} ON {table_name} ({column_names});

パラメータの説明:

{index_name} : セカンダリインデックスの名前。
{table_name} : テーブル名。
{column_names} : セミコロンのコンマで区切られた、索引付けされる列の名前。

新しいテーブルを作成するときにセカンダリインデックスを作成する

テーブルの作成と同時にセカンダリインデックスを作成するには、 KEYキーワードを含む句をテーブルを作成ステートメントの最後に追加します。

KEY `{index_name}` (`{column_names}`)

パラメータの説明:

{index_name} : セカンダリインデックスの名前。
{column_names} : セミコロンのコンマで区切られた、索引付けされる列の名前。

副次索引作成のルール

インデックス作成のベストプラクティスを参照してください。

例

bookshopのアプリケーションで、特定の年に出版されたすべての書籍の検索をサポートするとします。

booksテーブルのフィールドは次のとおりです。

フィールド名	タイプ	フィールドの説明
ID	bigint(20)	書籍の一意の ID
題名	varchar(100)	書名
タイプ	列挙	書籍の種類 (雑誌、アニメ、教材など)
株式	bigint(20)	ストック
価格	10 進数 (15,2)	価格
published_at	日付時刻	発行日

booksテーブルは、次の SQL ステートメントを使用して作成されます。

CREATE TABLE `bookshop`.`books` (
  `id` bigint(20) AUTO_RANDOM NOT NULL,
  `title` varchar(100) NOT NULL,
  `type` enum('Magazine', 'Novel', 'Life', 'Arts', 'Comics', 'Education & Reference', 'Humanities & Social Sciences', 'Science & Technology', 'Kids', 'Sports') NOT NULL,
  `published_at` datetime NOT NULL,
  `stock` int(11) DEFAULT '0',
  `price` decimal(15,2) DEFAULT '0.0',
  PRIMARY KEY (`id`) CLUSTERED
) DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_bin;

年による検索機能をサポートするには、特定の年に発行されたすべての書籍を検索する SQL ステートメントを作成する必要があります。 2022 年を例にとると、次のように SQL ステートメントを記述します。

SELECT * FROM `bookshop`.`books` WHERE `published_at` >= '2022-01-01 00:00:00' AND `published_at` < '2023-01-01 00:00:00';

SQL ステートメントの実行計画を確認するには、 EXPLAINステートメントを使用できます。

EXPLAIN SELECT * FROM `bookshop`.`books` WHERE `published_at` >= '2022-01-01 00:00:00' AND `published_at` < '2023-01-01 00:00:00';

以下は、実行計画の出力例です。

+-------------------------+----------+-----------+---------------+--------------------------------------------------------------------------------------------------------------------------+
| id                      | estRows  | task      | access object | operator info                                                                                                            |
+-------------------------+----------+-----------+---------------+--------------------------------------------------------------------------------------------------------------------------+
| TableReader_7           | 346.32   | root      |               | data:Selection_6                                                                                                         |
| └─Selection_6           | 346.32   | cop[tikv] |               | ge(bookshop.books.published_at, 2022-01-01 00:00:00.000000), lt(bookshop.books.published_at, 2023-01-01 00:00:00.000000) |
|   └─TableFullScan_5     | 20000.00 | cop[tikv] | table:books   | keep order:false                                                                                                         |
+-------------------------+----------+-----------+---------------+--------------------------------------------------------------------------------------------------------------------------+
3 rows in set (0.61 sec)

出力例では、 TableFullScanがid列に表示されています。これは、TiDB がこのクエリのbooksテーブルでフルテーブルスキャンを実行する準備ができていることを意味します。ただし、大量のデータの場合、全表スキャンは非常に遅くなり、致命的な影響を与える可能性があります。

このような影響を避けるために、次のようにpublished_at列のインデックスをbooksテーブルに追加できます。

CREATE INDEX `idx_book_published_at` ON `bookshop`.`books` (`bookshop`.`books`.`published_at`);

インデックスを追加したら、再度EXPLAINステートメントを実行して実行計画を確認します。

以下は出力例です。

+-------------------------------+---------+-----------+--------------------------------------------------------+-------------------------------------------------------------------+
| id                            | estRows | task      | access object                                          | operator info                                                     |
+-------------------------------+---------+-----------+--------------------------------------------------------+-------------------------------------------------------------------+
| IndexLookUp_10                | 146.01  | root      |                                                        |                                                                   |
| ├─IndexRangeScan_8(Build)     | 146.01  | cop[tikv] | table:books, index:idx_book_published_at(published_at) | range:[2022-01-01 00:00:00,2023-01-01 00:00:00), keep order:false |
| └─TableRowIDScan_9(Probe)     | 146.01  | cop[tikv] | table:books                                            | keep order:false                                                  |
+-------------------------------+---------+-----------+--------------------------------------------------------+-------------------------------------------------------------------+
3 rows in set (0.18 sec)

出力では、 TableFullScanの代わりにIndexRangeScanが表示されます。これは、TiDB がインデックスを使用してこのクエリを実行する準備ができていることを意味します。

実行計画のTableFullScanやIndexRangeScanなどの単語は、TiDB ではオペレーターです。実行計画と演算子の詳細については、 TiDB クエリ実行計画の概要を参照してください。

実行計画は、毎回同じ演算子を返すわけではありません。これは、TiDB がコストベースの最適化 (CBO)アプローチを使用しているためです。このアプローチでは、実行計画はルールとデータ分散の両方に依存します。 TiDB SQLパフォーマンスの詳細については、 SQL チューニングの概要を参照してください。

ノート：
TiDB はクエリ時の明示的なインデックスの使用もサポートしており、オプティマイザーのヒントまたはSQL 計画管理 (SPM)を使用して人為的にインデックスの使用を制御できます。ただし、インデックス、オプティマイザヒント、または SPM についてよく知らない場合は、予期しない結果を避けるためにこの機能を使用しないでください。

テーブルのインデックスをクエリするには、次のインデックスを表示ステートメントを使用できます。

SHOW INDEXES FROM `bookshop`.`books`;

次に出力例を示します。

+-------+------------+-----------------------+--------------+--------------+-----------+-------------+----------+--------+------+------------+---------+---------------+---------+------------+-----------+
| Table | Non_unique | Key_name              | Seq_in_index | Column_name  | Collation | Cardinality | Sub_part | Packed | Null | Index_type | Comment | Index_comment | Visible | Expression | Clustered |
+-------+------------+-----------------------+--------------+--------------+-----------+-------------+----------+--------+------+------------+---------+---------------+---------+------------+-----------+
| books |          0 | PRIMARY               |            1 | id           | A         |           0 |     NULL | NULL   |      | BTREE      |         |               | YES     | NULL       | YES       |
| books |          1 | idx_book_published_at |            1 | published_at | A         |           0 |     NULL | NULL   |      | BTREE      |         |               | YES     | NULL       | NO        |
+-------+------------+-----------------------+--------------+--------------+-----------+-------------+----------+--------+------+------------+---------+---------------+---------+------------+-----------+
2 rows in set (1.63 sec)

次のステップ

データベースを作成し、それにテーブルとセカンダリインデックスを追加したら、データ書きますと読んだの機能をアプリケーションに追加することができます。

セカンダリ インデックスを作成する