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

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

始める前に

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

• TiDB Cloud(開発者層) で TiDB クラスターを構築する .
• スキーマ設計の概要を読んでください。
• データベースを作成する .
• テーブルを作成する .

二次索引とは

セカンダリ インデックスは、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テーブルのフィールドは次のとおりです。

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 がコストベースの最適化 (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)

次のステップ

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