重要

このページは英語版のページを機械翻訳しています。原文はこちらからご覧ください。

分割リージョン

TiDB に作成された新しいテーブルごとに、このテーブルのデータを格納するために、デフォルトでリージョンつのセグメントが分割されます。このデフォルトの動作は、TiDB 構成ファイルのsplit-tableによって制御されます。このリージョンのデータがデフォルトのリージョンサイズ制限を超えると、リージョンは2 つに分割され始めます。

上記の場合、最初はリージョンが 1 つしかないため、すべての書き込み要求はリージョンが配置されている TiKV で発生します。新しく作成されたテーブルに対して大量の書き込みが発生すると、ホットスポットが発生します。

上記のシナリオのホットスポット問題を解決するために、TiDB は事前分割機能を導入しました。この機能は、指定されたパラメータに従って特定のテーブルの複数のリージョンを事前に分割し、各 TiKV ノードに分散させることができます。

注記：
この機能はTiDB Cloudサーバーレスクラスターでは使用できません。

概要

SplitRegionStmt
SplitSyntaxOption
TableName
PartitionNameList
SplitOption
RowValue

SplitRegionStmt ::=
    "SPLIT" SplitSyntaxOption "TABLE" TableName PartitionNameList? ("INDEX" IndexName)? SplitOption

SplitSyntaxOption ::=
    ("REGION" "FOR")? "PARTITION"?

TableName ::=
    (SchemaName ".")? Identifier

PartitionNameList ::=
    "PARTITION" "(" PartitionName ("," PartitionName)* ")"

SplitOption ::=
    ("BETWEEN" RowValue "AND" RowValue "REGIONS" NUM
|   "BY" RowValue ("," RowValue)* )

RowValue ::=
    "(" ValuesOpt ")"

分割リージョンの使用

分割リージョン構文には 2 つのタイプがあります。

均等分割の構文:
```
SPLIT TABLE table_name [INDEX index_name] BETWEEN (lower_value) AND (upper_value) REGIONS region_num
```
BETWEEN lower_value AND upper_value REGIONS region_num上限、下限、およびリージョンの量を定義します。現在の領域は、上限と下限の間の領域の数 ( region_numで指定) に均等に分割されます。
不均等分割の構文:
```
SPLIT TABLE table_name [INDEX index_name] BY (value_list) [, (value_list)] ...
```
BY value_list… 、現在のリージョンを分割する基準となる一連のポイントを手動で指定します。データが不均一に分散されているシナリオに適しています。

次の例は、 SPLITのステートメントの結果を示しています。

+--------------------+----------------------+
| TOTAL_SPLIT_REGION | SCATTER_FINISH_RATIO |
+--------------------+----------------------+
| 4                  | 1.0                  |
+--------------------+----------------------+

TOTAL_SPLIT_REGION : 新しく分割されたリージョンの数。
SCATTER_FINISH_RATIO : 新しく分割された領域の分散の完了率。2 1.0すべての領域が分散されていることを意味します。4 0.5領域の半分だけが分散されており、残りは分散中であることを意味します。

注記：
次の 2 つのセッション変数は、 SPLITステートメントの動作に影響を与える可能性があります。
tidb_wait_split_region_finish : リージョンを分散するのに時間がかかる場合があります。この期間は、PD のスケジュールと TiKV の負荷によって異なります。この変数は、 SPLIT REGIONのステートメントを実行するときに、すべてのリージョンが分散されるまで結果をクライアントに返すかどうかを制御するために使用されます。値が1 (デフォルト) に設定されている場合、TiDB は分散が完了した後にのみ結果を返します。値が0に設定されている場合、TiDB は分散ステータスに関係なく結果を返します。
tidb_wait_split_region_timeout : この変数は、 SPLIT REGIONのステートメントの実行タイムアウトを秒単位で設定します。デフォルト値は 300 秒です。4 split操作が期間内に完了しない場合、TiDB はタイムアウトエラーを返します。

テーブルリージョンを分割

各テーブルの行データのキーはtable_idとrow_idでエンコードされます。形式は次のとおりです。

t[table_id]_r[row_id]

たとえば、 table_idが 22 でrow_idが 11 の場合:

t22_r11

同じテーブル内の行データには同じtable_id含まれますが、各行にはリージョン分割に使用できる固有のrow_id含まれます。

均等分割

row_id整数なので、分割するキーの値は、指定されたlower_value 、 upper_value 、およびregion_numに従って計算できます。TiDB は最初にステップ値 ( step = (upper_value - lower_value)/region_num ) を計算します。次に、 lower_valueからupper_valueまでの各「ステップ」ごとに均等に分割され、 region_numで指定された数の領域が生成されます。

たとえば、テーブル t のキー範囲minInt64 ～ maxInt64から 16 個の均等に分割されたリージョンが必要な場合は、次のステートメントを使用できます。

SPLIT TABLE t BETWEEN (-9223372036854775808) AND (9223372036854775807) REGIONS 16;

このステートメントは、テーブル t を minInt64 から maxInt64 までの 16 の領域に分割します。指定された主キーの範囲が指定された範囲よりも小さい場合 (たとえば、0~1000000000)、minInt64 と maxInt64 の代わりにそれぞれ 0 と 1000000000 を使用して領域を分割できます。

SPLIT TABLE t BETWEEN (0) AND (1000000000) REGIONS 16;

不平等な分割

既知のデータが不均等に分散されており、リージョンをキー範囲 -inf ~ 10000、10000 ~ 90000、90000 ~ +inf にそれぞれ分割したい場合は、以下に示すように固定ポイントを設定することでこれを実現できます。

SPLIT TABLE t BY (10000), (90000);

分割インデックスリージョン

テーブル内のインデックスデータのキーは、 table_id 、 index_id 、およびインデックス列の値でエンコードされます。形式は次のとおりです。

t[table_id]_i[index_id][index_value]

たとえば、 table_idが 22、3 がindex_id index_value abc の場合:

t22_i5abc

1 つのテーブル内の同じインデックスデータのtable_idとindex_id同じです。インデックス領域を分割するには、 index_valueに基づいて領域を分割する必要があります。

こぼしても

インデックスを均等に分割する方法は、データを均等に分割する方法と同じです。ただし、 index_value整数ではない可能性があるため、ステップの値の計算はより複雑になります。

まず、 upperとlowerの値がバイト配列にエンコードされます。5 とlowerバイト配列の最長共通プレフィックスを削除した後、 lowerとupperの最初の 8 バイトが uint64 形式に変換されます。次に、 step = (upper - lower)/num計算されます。その後、計算されたステップがバイト配列にエンコードされ、インデックス分割のupperにlowerとupperバイト配列の最長共通プレフィックスに追加されます。次に例を示します。

idxインデックスの列が整数型の場合、次の SQL ステートメントを使用してインデックスデータを分割できます。

SPLIT TABLE t INDEX idx BETWEEN (-9223372036854775808) AND (9223372036854775807) REGIONS 16;

このステートメントは、テーブル t のインデックス idx のリージョンをminInt64からmaxInt64までの 16 個のリージョンに分割します。

インデックス idx1 の列が varchar 型であり、インデックスデータをプレフィックス文字で分割する場合。

SPLIT TABLE t INDEX idx1 BETWEEN ("a") AND ("z") REGIONS 25;

このステートメントは、インデックス idx1 を a ～ z の 25 の領域に分割します。リージョン1 の範囲は[minIndexValue, b) 、リージョン2 の範囲は[b, c) 、…リージョン25 の範囲は[y, minIndexValue]です。インデックスidxの場合、プレフィックスがaのデータはリージョン1 に書き込まれ、プレフィックスがbのデータはリージョン2 に書き込まれます。

上記の分割方法では、上限がzではなく{ (ASCII でzの次の文字) であるため、プレフィックスがyとz両方のデータがリージョン25 に書き込まれます。したがって、より正確な分割方法は次のとおりです。

SPLIT TABLE t INDEX idx1 BETWEEN ("a") AND ("{") REGIONS 26;

このステートメントは、テーブルtのインデックス idx1 を a~ {の 26 の領域に分割します。リージョン1 の範囲は[minIndexValue, b) 、リージョン2 の範囲は[b, c) 、…リージョン25 の範囲は[y, z) 、リージョン26 の範囲は[z, maxIndexValue)です。

インデックスidx2の列が timestamp/datetime のような時間型で、インデックスリージョンを年ごとに分割する場合:

SPLIT TABLE t INDEX idx2 BETWEEN ("2010-01-01 00:00:00") AND ("2020-01-01 00:00:00") REGIONS 10;

このステートメントは、表tのインデックスidx2のリージョンを2010-01-01 00:00:00から2020-01-01 00:00:00までの 10 の Region に分割します。Region 1 のリージョンは[minIndexValue, 2011-01-01 00:00:00)で、リージョン 2 の範囲は[2011-01-01 00:00:00, 2012-01-01 00:00:00)です。

インデックスリージョンを日ごとに分割する場合は、次の例を参照してください。

SPLIT TABLE t INDEX idx2 BETWEEN ("2020-06-01 00:00:00") AND ("2020-07-01 00:00:00") REGIONS 30;

このステートメントは、表tのインデックスidex2の 2020 年 6 月のデータを 30 のリージョンに分割し、各リージョンは1 日を表します。

他のタイプのインデックス列のリージョン分割方法も同様です。

結合インデックスのデータリージョン分割の場合、唯一の違いは、複数の列の値を指定できることです。

たとえば、インデックスidx3 (a, b)には 2 つの列が含まれており、列aはタイムスタンプ型、列bは int です。列aに従って時間範囲を分割するだけの場合は、単一列の時間インデックスを分割するための SQL ステートメントを使用できます。この場合、列bの値をlower_valueとupper_velueに指定しないでください。

SPLIT TABLE t INDEX idx3 BETWEEN ("2010-01-01 00:00:00") AND ("2020-01-01 00:00:00") REGIONS 10;

同じ時間範囲内で、列 b に従ってさらに 1 つの分割を実行する場合、分割時に列 b の値を指定するだけです。

SPLIT TABLE t INDEX idx3 BETWEEN ("2010-01-01 00:00:00", "a") AND ("2010-01-01 00:00:00", "z") REGIONS 10;

このステートメントは、列 a と同じ時間プレフィックスを持つ列 b の値に従って、a ～ z の範囲の 10 個のリージョンを分割します。列 a に指定された値が異なる場合、この場合は列 b の値が使用されない可能性があります。

テーブルの主キーが非クラスター化インデックスの場合、リージョンを分割するときにPRIMARYキーワードをエスケープするためにバッククォート`使用する必要があります。例:

SPLIT TABLE t INDEX `PRIMARY` BETWEEN (-9223372036854775808) AND (9223372036854775807) REGIONS 16;

不平等な分割

インデックスデータは、指定されたインデックス値によって分割することもできます。

たとえば、列aが varchar 型で、列bが timestamp 型のidx4 (a,b)あります。

SPLIT TABLE t1 INDEX idx4 BY ("a", "2000-01-01 00:00:01"), ("b", "2019-04-17 14:26:19"), ("c", "");

このステートメントは、4 つの領域を分割するための 3 つの値を指定します。各リージョンの範囲は次のとおりです。

region1  [ minIndexValue               , ("a", "2000-01-01 00:00:01"))
region2  [("a", "2000-01-01 00:00:01") , ("b", "2019-04-17 14:26:19"))
region3  [("b", "2019-04-17 14:26:19") , ("c", "")                   )
region4  [("c", "")                    , maxIndexValue               )

パーティションテーブルの分割領域

パーティション化されたテーブルのリージョンの分割は、通常のテーブルのリージョンの分割と同じです。唯一の違いは、すべてのパーティションに対して同じ分割操作が実行されることです。

均等分割の構文:

SPLIT [PARTITION] TABLE t [PARTITION] [(partition_name_list...)] [INDEX index_name] BETWEEN (lower_value) AND (upper_value) REGIONS region_num

不均等分割の構文:

SPLIT [PARTITION] TABLE table_name [PARTITION (partition_name_list...)] [INDEX index_name] BY (value_list) [, (value_list)] ...

パーティションテーブルの分割領域の例

パーティションテーブルtを作成します。2 つのパーティションに分割されたハッシュテーブルを作成するとします。例のステートメントは次のようになります。

CREATE TABLE t (a INT, b INT, INDEX idx(a)) PARTITION BY HASH(a) PARTITIONS 2;

テーブルtを作成した後、リージョンは各パーティションに分割されます。このテーブルのリージョンを表示するには、 SHOW TABLE REGIONS構文を使用します。

SHOW TABLE t REGIONS;

+-----------+-----------+---------+-----------+-----------------+------------------+------------+---------------+------------+----------------------+------------------+
| REGION_ID | START_KEY | END_KEY | LEADER_ID | LEADER_STORE_ID | PEERS            | SCATTERING | WRITTEN_BYTES | READ_BYTES | APPROXIMATE_SIZE(MB) | APPROXIMATE_KEYS |
+-----------+-----------+---------+-----------+-----------------+------------------+------------+---------------+------------+----------------------+------------------+
| 1978      | t_1400_   | t_1401_ | 1979      | 4               | 1979, 1980, 1981 | 0          | 0             | 0          | 1                    | 0                |
| 6         | t_1401_   |         | 17        | 4               | 17, 18, 21       | 0          | 223           | 0          | 1                    | 0                |
+-----------+-----------+---------+-----------+-----------------+------------------+------------+---------------+------------+----------------------+------------------+

SPLIT構文を使用して、各パーティションのリージョンを分割します。各パーティションの[0,10000]範囲のデータを 4 つの領域に分割するとします。例のステートメントは次のとおりです。
```
split partition table t between (0) and (10000) regions 4;
```
上記のステートメントでは、 0と10000 、散布するホットスポットデータに対応する上限と下限のrow_id表します。
注記：
この例は、ホットスポットデータが均等に分散されているシナリオにのみ適用されます。ホットスポットデータが指定されたデータ範囲内で不均等に分散されている場合は、パーティションテーブルの分割領域の不均等分割の構文を参照してください。

SHOW TABLE REGIONS構文を使用して、このテーブルのリージョンを再度表示します。このテーブルには現在 10 個のリージョンがあり、各パーティションには 5 個のリージョンがあり、そのうち 4 個は行データで、1 個はインデックスデータであることがわかります。

SHOW TABLE t REGIONS;

+-----------+---------------+---------------+-----------+-----------------+------------------+------------+---------------+------------+----------------------+------------------+
| REGION_ID | START_KEY     | END_KEY       | LEADER_ID | LEADER_STORE_ID | PEERS            | SCATTERING | WRITTEN_BYTES | READ_BYTES | APPROXIMATE_SIZE(MB) | APPROXIMATE_KEYS |
+-----------+---------------+---------------+-----------+-----------------+------------------+------------+---------------+------------+----------------------+------------------+
| 1998      | t_1400_r      | t_1400_r_2500 | 2001      | 5               | 2000, 2001, 2015 | 0          | 132           | 0          | 1                    | 0                |
| 2006      | t_1400_r_2500 | t_1400_r_5000 | 2016      | 1               | 2007, 2016, 2017 | 0          | 35            | 0          | 1                    | 0                |
| 2010      | t_1400_r_5000 | t_1400_r_7500 | 2012      | 2               | 2011, 2012, 2013 | 0          | 35            | 0          | 1                    | 0                |
| 1978      | t_1400_r_7500 | t_1401_       | 1979      | 4               | 1979, 1980, 1981 | 0          | 621           | 0          | 1                    | 0                |
| 1982      | t_1400_       | t_1400_r      | 2014      | 3               | 1983, 1984, 2014 | 0          | 35            | 0          | 1                    | 0                |
| 1990      | t_1401_r      | t_1401_r_2500 | 1992      | 2               | 1991, 1992, 2020 | 0          | 120           | 0          | 1                    | 0                |
| 1994      | t_1401_r_2500 | t_1401_r_5000 | 1997      | 5               | 1996, 1997, 2021 | 0          | 129           | 0          | 1                    | 0                |
| 2002      | t_1401_r_5000 | t_1401_r_7500 | 2003      | 4               | 2003, 2023, 2022 | 0          | 141           | 0          | 1                    | 0                |
| 6         | t_1401_r_7500 |               | 17        | 4               | 17, 18, 21       | 0          | 601           | 0          | 1                    | 0                |
| 1986      | t_1401_       | t_1401_r      | 1989      | 5               | 1989, 2018, 2019 | 0          | 123           | 0          | 1                    | 0                |
+-----------+---------------+---------------+-----------+-----------------+------------------+------------+---------------+------------+----------------------+------------------+

各パーティションのインデックスのリージョンを分割することもできます。たとえば、 idxインデックスの[1000,10000]範囲を 2 つのリージョンに分割できます。例のステートメントは次のとおりです。
```
SPLIT PARTITION TABLE t INDEX idx BETWEEN (1000) AND (10000) REGIONS 2;
```

単一パーティションの分割リージョンの例

分割するパーティションを指定できます。

パーティションテーブルを作成します。3 つのパーティションに分割された範囲パーティションテーブルを作成するとします。例のステートメントは次のようになります。

CREATE TABLE t ( a INT, b INT, INDEX idx(b)) PARTITION BY RANGE( a ) (
    PARTITION p1 VALUES LESS THAN (10000),
    PARTITION p2 VALUES LESS THAN (20000),
    PARTITION p3 VALUES LESS THAN (MAXVALUE) );

p1パーティションの[0,10000]の範囲のデータを 2 つのリージョンに分割するとします。例のステートメントは次のようになります。
```
SPLIT PARTITION TABLE t PARTITION (p1) BETWEEN (0) AND (10000) REGIONS 2;
```
p2パーティションの[10000,20000]の範囲のデータを 2 つのリージョンに分割するとします。例のステートメントは次のようになります。
```
SPLIT PARTITION TABLE t PARTITION (p2) BETWEEN (10000) AND (20000) REGIONS 2;
```

SHOW TABLE REGIONS構文を使用して、このテーブルのリージョンを表示できます。

SHOW TABLE t REGIONS;

+-----------+----------------+----------------+-----------+-----------------+------------------+------------+---------------+------------+----------------------+------------------+
| REGION_ID | START_KEY      | END_KEY        | LEADER_ID | LEADER_STORE_ID | PEERS            | SCATTERING | WRITTEN_BYTES | READ_BYTES | APPROXIMATE_SIZE(MB) | APPROXIMATE_KEYS |
+-----------+----------------+----------------+-----------+-----------------+------------------+------------+---------------+------------+----------------------+------------------+
| 2040      | t_1406_        | t_1406_r_5000  | 2045      | 3               | 2043, 2045, 2044 | 0          | 0             | 0          | 1                    | 0                |
| 2032      | t_1406_r_5000  | t_1407_        | 2033      | 4               | 2033, 2034, 2035 | 0          | 0             | 0          | 1                    | 0                |
| 2046      | t_1407_        | t_1407_r_15000 | 2048      | 2               | 2047, 2048, 2050 | 0          | 35            | 0          | 1                    | 0                |
| 2036      | t_1407_r_15000 | t_1408_        | 2037      | 4               | 2037, 2038, 2039 | 0          | 0             | 0          | 1                    | 0                |
| 6         | t_1408_        |                | 17        | 4               | 17, 18, 21       | 0          | 214           | 0          | 1                    | 0                |
+-----------+----------------+----------------+-----------+-----------------+------------------+------------+---------------+------------+----------------------+------------------+

p1とp2パーティションのidxのインデックスの[0,20000]の範囲を 2 つのリージョンに分割するとします。例のステートメントは次のようになります。
```
SPLIT PARTITION TABLE t PARTITION (p1,p2) INDEX idx BETWEEN (0) AND (20000) REGIONS 2;
```

事前分割領域

AUTO_RANDOMまたはSHARD_ROW_ID_BITS属性でテーブルを作成する場合、テーブルの作成直後にテーブルを均等にリージョンに事前分割したい場合は、 PRE_SPLIT_REGIONSオプションを指定することもできます。テーブルの事前分割リージョンの数は2^(PRE_SPLIT_REGIONS)です。

注記：
PRE_SPLIT_REGIONSの値はSHARD_ROW_ID_BITSまたはAUTO_RANDOMの値以下でなければなりません。

tidb_scatter_regionグローバル変数はPRE_SPLIT_REGIONSの動作に影響します。この変数は、テーブル作成後に結果を返す前に、リージョンが事前に分割され、分散されるのを待つかどうかを制御します。テーブル作成後に書き込みが集中する場合は、この変数の値をglobalに設定する必要があります。そうすると、TiDB はクラスター全体のデータ分散に従って、新しく作成されたテーブルのリージョンを分散します。そうでない場合、TiDB は分散が完了する前にデータを書き込み、書き込みパフォーマンスに大きな影響を与えます。

pre_split_regions の例

CREATE TABLE t (a INT, b INT, INDEX idx1(a)) SHARD_ROW_ID_BITS = 4 PRE_SPLIT_REGIONS=2;

テーブルを構築した後、このステートメントはテーブル t の4 + 1領域を分割します。3 4 (2^2)領域はテーブル行データを保存するために使用され、1 つのリージョンはidx1のインデックスデータを保存するために使用されます。

4 つのテーブル領域の範囲は次のとおりです。

region1:   [ -inf      ,  1<<61 )
region2:   [ 1<<61     ,  2<<61 )
region3:   [ 2<<61     ,  3<<61 )
region4:   [ 3<<61     ,  +inf  )

注記：
Split リージョンステートメントによって分割されたリージョンは、PD のリージョンの統合のスケジューラによって制御されます。PD がすぐに新しく分割されたリージョンを再マージしないようにするには、リージョンマージ機能に関連するテーブル属性または動的に変更する構成項目を使用する必要があります。

MySQL 互換性

このステートメントは、MySQL 構文に対する TiDB 拡張です。

分割リージョン

概要

分割リージョンの使用

テーブルリージョンを分割

均等分割

不平等な分割

分割インデックスリージョン

こぼしても

不平等な分割

パーティションテーブルの分割領域

パーティションテーブルの分割領域の例

単一パーティションの分割リージョンの例

事前分割領域

pre_split_regions の例

MySQL 互換性

参照

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