テーブルレベルのデータアフィニティ（v8.5.5 の新機能）

テーブルレベルのデータアフィニティは、テーブルレベルでデータ分散をスケジュールするためのPDメカニズムです。このメカニズムは、同じテーブルまたはパーティションのリージョンのLeaderとボーターレプリカがTiKVクラスター全体にどのように分散されるかを制御します。

PDアフィニティスケジューリングを有効にし、テーブルのAFFINITYオプションをtableまたはpartitionに設定すると、PDは同じテーブルまたはパーティションに属するリージョンを同じアフィニティグループにグループ化します。スケジューリング中、PDはこれらのリージョンのLeaderとボーターレプリカを、少数のTiKVノードの同じサブセットに配置することを優先します。これにより、クエリ中のノード間アクセスによって発生するネットワークレイテンシーが削減され、クエリパフォーマンスが向上します。

制限事項

テーブル レベルのデータ アフィニティを使用する前に、次の制限に注意してください。

• この機能はPDマイクロサービスモードでは有効になりません。
• この機能は一時テーブルおよびビューでは動作しません。
• パーティションテーブルデータアフィニティが設定されると、パーティションの追加、削除、再編成、スワップなど、テーブルのパーティション構成の変更はサポートされなくなります。パーティション構成を変更するには、まずそのテーブルのアフィニティ設定を削除する必要があります。
• 大容量データを扱う場合、ディスク容量を事前に評価してください。アフィニティを有効にすると、PDはテーブルまたはパーティションのリージョンを、少数のTiKVノードの同じサブセットに優先的にスケジュールします。データ量の多いテーブルやパーティションの場合、これによりこれらのノードのディスク使用量が大幅に増加する可能性があります。事前にディスク容量を評価し、監視することをお勧めします。
• データアフィニティは、Leaderとボーターレプリカの分散にのみ影響します。テーブルにLearnerレプリカ（ TiFlashなど）がある場合、それらの分散はアフィニティ設定の影響を受けません。

前提条件

PDアフィニティスケジューリングはデフォルトで無効になっています。テーブルまたはパーティションのアフィニティを設定する前に、この機能を有効にして設定する必要があります。

1. アフィニティ スケジューリングを有効にするには、PD 構成項目schedule.affinity-schedule-limit 0より大きい値に設定します。

   たとえば、次のコマンドは値を4に設定し、PD が最大 4 つのアフィニティ スケジューリング タスクを同時に実行できるようにします。

   pd-ctl config set schedule.affinity-schedule-limit 4
   

2. （オプション）必要に応じてPD設定項目schedule.max-affinity-merge-region-sizeを変更します。デフォルト値は256です。これは、同じアフィニティグループ内の隣接する小さなリージョンを自動的にマージするためのサイズしきい値を制御します。5に設定すると0アフィニティグループ内の隣接する小さなリージョンの自動マージが無効になります。

使用法

このセクションでは、テーブルまたはパーティションのアフィニティを構成する方法と、アフィニティのスケジュール状態を表示する方法について説明します。

テーブルまたはパーティションのアフィニティを構成する

CREATE TABLEまたはALTER TABLEステートメントのAFFINITYオプションを使用して、テーブルまたはパーティションのアフィニティを構成できます。

例

パーティションテーブルを作成するときにアフィニティを有効にします。

CREATE TABLE t1 (a INT) AFFINITY = 'table';

パーティションテーブルを作成するときに、各パーティションのアフィニティを有効にします。

CREATE TABLE tp1 (a INT)
  AFFINITY = 'partition'
  PARTITION BY HASH(a) PARTITIONS 4;

既存の非パーティションテーブルのアフィニティを有効にする:

CREATE TABLE t2 (a INT);
ALTER TABLE t2 AFFINITY = 'table';

テーブルアフィニティを無効にする:

ALTER TABLE t1 AFFINITY = '';

アフィニティ情報をビュー

テーブルまたはパーティションのアフィニティ情報は、次の方法で表示できます。

• SHOW AFFINITY番目のステートメントを実行します。3 Statusの列には、アフィニティが有効になっているテーブルまたはパーティションと、それらのスケジュールステータスが表示されます。5 Statusの列の値の意味は次のとおりです。

  • Pending : リーダーまたは投票者がまだ決定されていない場合など、PD はテーブルまたはパーティションのアフィニティ スケジューリングを開始していません。
  • Preparing : PD はアフィニティ要件を満たすように領域をスケジュールしています。
  • Stable : すべてのリージョンが目標配布に到達しました。

• INFORMATION_SCHEMA.TABLESテーブルをクエリし、 TIDB_AFFINITY列目でテーブルのアフィニティ レベルを確認します。

• INFORMATION_SCHEMA.PARTITIONSテーブルをクエリし、パーティションのアフィニティ レベルのTIDB_AFFINITY列を確認します。

注記

• リージョンの自動分割：リージョンがアフィニティグループに属し、アフィニティが有効な場合、リージョンが過剰に作成されてアフィニティ効果が弱まるのを防ぐため、そのリージョンの自動分割はデフォルトで無効になっています。自動分割は、リージョンサイズがschedule.max-affinity-merge-region-sizeの4倍を超えた場合にのみトリガーされます。TiKVまたはPD以外のコンポーネントによってトリガーされる分割（ SPLIT TABLEによってトリガーされる手動分割など）には、この制限は適用されません。

• 縮退および有効期限切れのメカニズム：アフィニティグループ内の対象のリーダーまたは投票者をホストするTiKVノードが利用できなくなった場合（例えば、ノード障害やディスク容量不足など）、Leaderが排除された場合、または既存の配置ルールと競合した場合、PDはアフィニティグループを縮退状態としてマークします。縮退中は、対応するテーブルまたはパーティションのアフィニティスケジューリングが一時停止されます。

  • 影響を受けたノードが 10 分以内に回復した場合、PD は元のアフィニティ設定に基づいてスケジュールを再開します。
  • 影響を受けたノードが10分以内に回復しない場合、アフィニティグループは期限切れとしてマークされます。この時点で、PDは通常のスケジューリング動作を復元し（ SHOW AFFINITYの状態がPendingに戻ります）、アフィニティグループ内のリーダーと投票者を自動的に更新して、アフィニティスケジューリングを再度有効にします。

関連するステートメントと構成

• CREATE TABLEとALTER TABLEのAFFINITYオプション
• SHOW AFFINITY
• PD構成項目: schedule.affinity-schedule-limitとschedule.max-affinity-merge-region-size