TiDB Self-Managed
Learning Center
お問い合わせ

TIDB_HOT_REGIONS_HISTORY

TIDB_HOT_REGIONS_HISTORYテーブルは、PD によって定期的にローカルに記録される履歴のホット リージョンに関する情報を提供します。

hot-regions-write-intervalを設定すると、記録間隔を指定できます。デフォルト値は 10 分です。 hot-regions-reserved-daysを設定することで、ホットリージョンの履歴情報を保存する期間を指定できます。デフォルト値は 7 日です。詳細はPD 構成ファイルの説明を参照してください。

USE information_schema;
DESC tidb_hot_regions_history;

+-------------+--------------+------+------+---------+-------+
| Field       | Type         | Null | Key  | Default | Extra |
+-------------+--------------+------+------+---------+-------+
| UPDATE_TIME | timestamp(6) | YES  |      | NULL    |       |
| DB_NAME     | varchar(64)  | YES  |      | NULL    |       |
| TABLE_NAME  | varchar(64)  | YES  |      | NULL    |       |
| TABLE_ID    | bigint(21)   | YES  |      | NULL    |       |
| INDEX_NAME  | varchar(64)  | YES  |      | NULL    |       |
| INDEX_ID    | bigint(21)   | YES  |      | NULL    |       |
| REGION_ID   | bigint(21)   | YES  |      | NULL    |       |
| STORE_ID    | bigint(21)   | YES  |      | NULL    |       |
| PEER_ID     | bigint(21)   | YES  |      | NULL    |       |
| IS_LEARNER  | tinyint(1)   | NO   |      | 0       |       |
| IS_LEADER   | tinyint(1)   | NO   |      | 0       |       |
| TYPE        | varchar(64)  | YES  |      | NULL    |       |
| HOT_DEGREE  | bigint(21)   | YES  |      | NULL    |       |
| FLOW_BYTES  | double       | YES  |      | NULL    |       |
| KEY_RATE    | double       | YES  |      | NULL    |       |
| QUERY_RATE  | double       | YES  |      | NULL    |       |
+-------------+--------------+------+------+---------+-------+
16 rows in set (0.00 sec)

TIDB_HOT_REGIONS_HISTORYテーブルのフィールドは次のとおりです。

  • UPDATE_TIME: ホットリージョンの更新時間。
  • DB_NAME: ホットリージョンが配置されているオブジェクトのデータベース名。
  • TABLE_ID: ホットリージョンが配置されているテーブルの ID。
  • TABLE_NAME: ホットリージョンが配置されているテーブルの名前。
  • INDEX_NAME: ホットリージョンが配置されているインデックスの名前。
  • INDEX_ID: ホットリージョンが配置されているインデックスの ID。
  • REGION_ID: ホットリージョンの ID。
  • STORE_ID: ホットリージョンがあるストアの ID。
  • PEER_ID: ホットリージョンに対応する Peer の ID。
  • IS_LEARNER: PEER が LEARNER かどうか。
  • IS_LEADER: PEER が LEADER かどうか。
  • TYPE: ホットリージョンのタイプ。
  • HOT_DEGREE: ホットリージョンのホット度。
  • FLOW_BYTES: リージョンで読み書きされたバイト数。
  • KEY_RATE: リージョンで読み書きされたキーの数。
  • QUERY_RATE: リージョンで書き込まれ、読み取られたクエリの数。

ノート：

UPDATE_TIME 、 REGION_ID 、 STORE_ID 、 PEER_ID 、 IS_LEARNER 、 IS_LEADER 、およびTYPEフィールドは、実行のために PD サーバーにプッシュダウンされます。テーブルを使用するオーバーヘッドを減らすには、検索の時間範囲を指定し、できるだけ多くの条件を指定する必要があります。たとえば、 select * from tidb_hot_regions_history where store_id = 11 and update_time > '2020-05-18 20:40:00' and update_time < '2020-05-18 21:40:00' and type='write'です。

一般的なユーザー シナリオ

  • 特定の期間内のホット リージョンをクエリします。 update_timeを実際の時間に置き換えます。

    SELECT * FROM INFORMATION_SCHEMA.TIDB_HOT_REGIONS_HISTORY WHERE update_time >'2021-08-18 21:40:00' and update_time <'2021-09-19 00:00:00';

    ノート：

    UPDATE_TIMEは Unix タイムスタンプもサポートします。たとえば、 update_time >TIMESTAMP('2021-08-18 21:40:00')またはupdate_time > FROM_UNIXTIME(1629294000.000)です。

  • 特定の期間内にテーブル内のホット リージョンをクエリします。 update_timeとtable_nameを実際の値に置き換えます。

    SELECT * FROM INFORMATION_SCHEMA.TIDB_HOT_REGIONS_HISTORY WHERE update_time >'2021-08-18 21:40:00' and update_time <'2021-09-19 00:00:00' and TABLE_NAME = 'table_name';

  • 特定の期間内のホット リージョンの分布を照会します。 update_timeとtable_nameを実際の値に置き換えます。

    SELECT count(region_id) cnt, store_id FROM INFORMATION_SCHEMA.TIDB_HOT_REGIONS_HISTORY WHERE update_time >'2021-08-18 21:40:00' and update_time <'2021-09-19 00:00:00' and table_name = 'table_name' GROUP BY STORE_ID ORDER BY cnt DESC;

  • 特定の期間内のホット リーダー リージョンの分布を照会します。 update_timeとtable_nameを実際の値に置き換えます。

    SELECT count(region_id) cnt, store_id FROM INFORMATION_SCHEMA.TIDB_HOT_REGIONS_HISTORY WHERE update_time >'2021-08-18 21:40:00' and update_time <'2021-09-19 00:00:00' and table_name = 'table_name' and is_leader=1 GROUP BY STORE_ID ORDER BY cnt DESC;

  • 特定の期間内のホット インデックス リージョンの分布を照会します。 update_timeとtable_nameを実際の値に置き換えます。

    SELECT count(region_id) cnt, index_name, store_id FROM INFORMATION_SCHEMA.TIDB_HOT_REGIONS_HISTORY WHERE update_time >'2021-08-18 21:40:00' and update_time <'2021-09-19 00:00:00' and table_name = 'table_name' group by index_name, store_id order by index_name,cnt desc;

  • 特定の期間内のホット インデックス リーダー リージョンの分布を照会します。 update_timeとtable_nameを実際の値に置き換えます。

    SELECT count(region_id) cnt, index_name, store_id FROM INFORMATION_SCHEMA.TIDB_HOT_REGIONS_HISTORY WHERE update_time >'2021-08-18 21:40:00' and update_time <'2022-09-19 00:00:00' and table_name = 'table_name' and is_leader=1 group by index_name, store_id order by index_name,cnt desc;