テーブル属性

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

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

注記：

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

使用法

テーブル属性は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属性が設定されていないとします。この場合、リージョンが条件を満たしていれば、1 時間後にリージョンをマージできます。3 属性が設定merge_option merge_optionに従って 1 時間後にリージョンをマージするかどうかを決定します。