テーブル属性

テーブル属性機能は、TiDBv5.3.0で導入されました。この機能を使用すると、特定の属性をテーブルまたはパーティションに追加して、属性に対応する操作を実行できます。たとえば、テーブル属性を使用して、リージョンのマージ動作を制御できます。

現在、TiDBは、リージョンのマージ動作を制御するために、テーブルまたはパーティションへのmerge_option属性の追加のみをサポートしています。 merge_option属性は、ホットスポットの処理方法の一部にすぎません。詳細については、ホットスポットの問題のトラブルシューティングを参照してください。

現在、TiDBは、リージョンのマージ動作を制御するために、テーブルまたはパーティションへのmerge_option属性の追加のみをサポートしています。 merge_option属性は、ホットスポットの処理方法の一部にすぎません。

ノート：
TiDB BinlogまたはTiCDCを使用してレプリケーションを実行するか、BRを使用して増分バックアップを実行する場合、レプリケーションまたはバックアップ操作は、テーブル属性を設定するDDLステートメントをスキップします。ダウンストリームまたはバックアップクラスターでテーブル属性を使用するには、ダウンストリームまたはバックアップクラスタでDDLステートメントを手動で実行する必要がありクラスタ。

使用法

table属性はkey=valueの形式です。複数の属性はコンマで区切られます。次の例では、 tは変更するテーブルの名前、 pは変更するパーティションの名前です。 []の項目はオプションです。

テーブルまたはパーティションの属性を設定します。

ALTER TABLE t [PARTITION p] ATTRIBUTES [=] 'key=value[, key1=value1...]';

テーブルまたはパーティションの属性をリセットします。
```
ALTER TABLE t [PARTITION p] ATTRIBUTES [=] DEFAULT;
```
すべてのテーブルとパーティションの属性を確認します。
```
SELECT * FROM information_schema.attributes;
```
テーブルまたはパーティションに構成されている属性を参照してください。
```
SELECT * FROM information_schema.attributes WHERE id='schema/t[/p]';
```
特定の属性を持つすべてのテーブルとパーティションを表示します。
```
SELECT * FROM information_schema.attributes WHERE attributes LIKE '%key%';
```

属性オーバーライドルール

テーブルに構成された属性は、テーブルのすべてのパーティションで有効になります。ただし、例外が1つあります。テーブルとパーティションが同じ属性で構成されているが、属性値が異なる場合、パーティション属性はテーブル属性をオーバーライドします。たとえば、テーブルtがkey=value属性で構成され、パーティションpがkey=value1で構成されているとします。

ALTER TABLE t ATTRIBUTES[=]'key=value';
ALTER TABLE t PARTITION p ATTRIBUTES[=]'key=value1';

この場合、 key=value1はp1パーティションで実際に有効になる属性です。

テーブル属性を使用してリージョンのマージ動作を制御する

ユーザーシナリオ

書き込みホットスポットまたは読み取りホットスポットがある場合は、テーブル属性を使用してリージョンのマージ動作を制御できます。最初にmerge_option属性をテーブルまたはパーティションに追加してから、その値をdenyに設定できます。 2つのシナリオは次のとおりです。

新しく作成されたテーブルまたはパーティションにホットスポットを書き込む

新しく作成されたテーブルまたはパーティションにデータが書き込まれるときにホットスポットの問題が発生した場合は、通常、リージョンを分割して分散させる必要があります。ただし、分割/分散操作と書き込みの間に一定の時間間隔がある場合、これらの操作は書き込みホットスポットを実際に回避するわけではありません。これは、テーブルまたはパーティションの作成時に実行される分割操作によって空のリージョンが生成されるため、時間間隔が存在する場合、分割されたリージョンがマージされる可能性があるためです。このケースを処理するには、 merge_option属性をテーブルまたはパーティションに追加し、属性値をdenyに設定します。

読み取り専用シナリオでの定期的な読み取りホットスポット

読み取り専用のシナリオで、リージョンを手動で分割することにより、テーブルまたはパーティションで発生する定期的な読み取りホットスポットを削減しようとし、ホットスポットの問題が解決された後に手動で分割されたリージョンをマージしたくないとします。この場合、テーブルまたはパーティションにmerge_option属性を追加し、その値をdenyに設定できます。

使用法

テーブルのリージョンがマージされないようにします。
```
ALTER TABLE t ATTRIBUTES 'merge_option=deny';
```
テーブルに属するリージョンのマージを許可します。
```
ALTER TABLE t ATTRIBUTES 'merge_option=allow';
```
テーブルの属性をリセットします。
```
ALTER TABLE t ATTRIBUTES DEFAULT;
```
パーティションのリージョンがマージされないようにします。
```
ALTER TABLE t PARTITION p ATTRIBUTES 'merge_option=deny';
```
パーティションに属するリージョンのマージを許可します。
```
ALTER TABLE t PARTITION p ATTRIBUTES 'merge_option=allow';
```
merge_optionの属性を構成したすべてのテーブルまたはパーティションを表示します。
```
SELECT * FROM information_schema.attributes WHERE attributes LIKE '%merge_option%';
```

属性オーバーライドルール

ALTER TABLE t ATTRIBUTES 'merge_option=deny';
ALTER TABLE t PARTITION p ATTRIBUTES 'merge_option=allow';

上記の2つの属性を同時に設定すると、パーティションpに属するリージョンを実際にマージできます。パーティションの属性がリセットされると、パーティションpはテーブルtから属性を継承し、リージョンをマージすることはできません。

ノート：
パーティションのあるテーブルの場合、 merge_option属性がテーブルレベルでのみ構成されていると、 merge_option=allowであっても、テーブルはデフォルトで実際のパーティション数に応じて複数のリージョンに分割されます。すべてのリージョンをマージするには、テーブルの属性をリセットしますにする必要があります。
merge_option属性を使用する場合は、PD構成パラメーターsplit-merge-intervalに注意する必要があります。 merge_option属性が構成されていないとします。この場合、リージョンが条件を満たす場合、リージョンはsplit-merge-intervalで指定された間隔の後にマージできます。 merge_option属性が構成されている場合、PDは、 merge_option構成に従って、指定された間隔の後にリージョンをマージするかどうかを決定します。

ノート：
パーティションのあるテーブルの場合、 merge_option属性がテーブルレベルでのみ構成されていると、 merge_option=allowであっても、テーブルはデフォルトで実際のパーティション数に応じて複数のリージョンに分割されます。すべてのリージョンをマージするには、テーブルの属性をリセットしますにする必要があります。
merge_option属性が構成されていないとします。この場合、リージョンが条件を満たす場合、リージョンは1時間後にマージできます。 merge_option属性が構成されている場合、PDは、 merge_option構成に従って、1時間後にリージョンをマージするかどうかを決定します。

このページの内容

使用法
属性オーバーライドルール
テーブル属性を使用してリージョンのマージ動作を制御する