From b23c7ffe93a5e20bc7341b517e74ca319153a533 Mon Sep 17 00:00:00 2001 From: AilinKid <314806019@qq.com> Date: Tue, 16 Jun 2020 14:58:59 +0800 Subject: [PATCH 1/5] refine tables, tidb_hot_regions and session_variable in information schema Signed-off-by: AilinKid <314806019@qq.com> --- .../system-table-information-schema.md | 42 +++++++++++++++++++ 1 file changed, 42 insertions(+) diff --git a/system-tables/system-table-information-schema.md b/system-tables/system-table-information-schema.md index b7bc755c328a..6aa9dc86e6cb 100644 --- a/system-tables/system-table-information-schema.md +++ b/system-tables/system-table-information-schema.md @@ -426,6 +426,11 @@ SELECT * FROM session_variables LIMIT 10; 10 rows in set (0.00 sec) ``` +`SESSION_VARIABLES` 表各列字段含义如下： + +* VARIABLE_NAME：数据库中 session 级变量的名称。 +* VARIABLE_VALUE：数据库中对应该 session 变量名的具体值。 + ## SLOW_QUERY 表 `SLOW_QUERY` 表中提供了当前节点的慢查询相关的信息，其内容通过解析当前节点的 TiDB 慢查询日志而来，列名和慢日志中的字段名是一一对应。关于如何使用该表调查和改善慢查询请参考[慢查询日志文档](/identify-slow-queries.md)。 @@ -694,6 +699,30 @@ SHOW TABLES [LIKE 'wild'] ``` +`TABLES` 表各列字段含义如下： + +* `TABLE_CATALOG`：表所属的目录的名称。该值始终为 `def`。 +* `TABLE_SCHEMA`：表所属数据库的名称。 +* `TABLE_NAME`：表的名称。 +* `TABLE_TYPE`：表的类型。 +* `ENGINE`：存储引擎类型。 +* `VERSION`：版本，默认值为10。 +* `ROW_FORMAT`：行格式。 +* `TABLE_ROWS`：该表中所存的行数。 +* `AVG_ROW_LENGTH`：该表中所存数据的平均行长度。 +* `DATA_LENGTH`：数据长度。 +* `MAX_DATA_LENGTH`：最大数据长度。 +* `INDEX_LENGTH`：索引长度。 +* `DATA_FREE`：空间碎片。 +* `AUTO_INCREMENT`：该表中字增主键自动增量的当前值。 +* `CREATE_TIME`：该表的创建时间。 +* `UPDATE_TIME`：该表的更新时间。 +* `CHECK_TIME`：该表的检查时间。 +* `TABLE_COLLATION`：该表的字符校验编码集。 +* `CHECKSUM`：校验和。 +* `CREATE_OPTIONS`：创建选项。 +* `TABLE_COMMENT`：表的注释、备注。 + 表中的信息大部分定义自 MySQL，此外有两列是 TiDB 新增的： * `TIDB_TABLE_ID`：标识表的内部 ID，该 ID 在一个 TiDB 集群内部唯一。 @@ -790,6 +819,19 @@ desc TIDB_HOT_REGIONS; +----------------+---------------------+------+-----+---------+-------+ ``` +`TIDB_HOT_REGIONS` 表各列字段含义如下： + +* TABLE_ID：热点 region 所在表的 ID。 +* INDEX_ID：热点 region 所在索引的 ID。 +* DB_NAME：热点 region 所在数据库对象的数据库名。 +* TABLE_NAME：热点 region 所在表的名称。 +* INDEX_NAME：热点 region 所在索引的名称。 +* REGION_ID：热点 region 的 ID。 +* TYPE：热点 region 的类型。 +* MAX_HOT_DEGREE：该 region 的最大热度。 +* REGION_COUNT：所在 instance 的 region 数量。 +* FLOW_BYTES：该 region 内读写的字节数量。 + ## TIDB_INDEXES 表 `TIDB_INDEXES` 记录了所有表中的 INDEX 信息。 From a1c46a3f3c37bdf9e402b089295b99383d72eca9 Mon Sep 17 00:00:00 2001 From: AilinKid <314806019@qq.com> Date: Wed, 17 Jun 2020 10:43:06 +0800 Subject: [PATCH 2/5] refine Signed-off-by: AilinKid <314806019@qq.com> --- system-tables/system-table-information-schema.md | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/system-tables/system-table-information-schema.md b/system-tables/system-table-information-schema.md index feb7f531008a..9aee0cb55108 100644 --- a/system-tables/system-table-information-schema.md +++ b/system-tables/system-table-information-schema.md @@ -700,15 +700,15 @@ SHOW TABLES * `TABLE_SCHEMA`：表所属数据库的名称。 * `TABLE_NAME`：表的名称。 * `TABLE_TYPE`：表的类型。 -* `ENGINE`：存储引擎类型。 +* `ENGINE`：存储引擎类型。该值暂为 ‘InnoDB’。 * `VERSION`：版本，默认值为10。 -* `ROW_FORMAT`：行格式。 -* `TABLE_ROWS`：该表中所存的行数。 -* `AVG_ROW_LENGTH`：该表中所存数据的平均行长度。 -* `DATA_LENGTH`：数据长度。 -* `MAX_DATA_LENGTH`：最大数据长度。 -* `INDEX_LENGTH`：索引长度。 -* `DATA_FREE`：空间碎片。 +* `ROW_FORMAT`：行格式。该值暂为 ‘Compact’。 +* `TABLE_ROWS`：统计信息中该表所存的行数。 +* `AVG_ROW_LENGTH`：该表中所存数据的平均行长度。平均行长度 = DATA_LENGTH / 统计信息中的行数。 +* `DATA_LENGTH`：数据长度。数据长度 = 统计信息中的行数 × 元组各列存储长度和，这里尚未考虑 TiKV 的副本数。 +* `MAX_DATA_LENGTH`：最大数据长度。该值暂为 0，表示没有最大数据长度的限制。 +* `INDEX_LENGTH`：索引长度。索引长度 = 统计信息中的行数 × 索引元组各列长度和，这里尚未考虑 TiKV 的副本数。 +* `DATA_FREE`：空间碎片。该值暂为 0。 * `AUTO_INCREMENT`：该表中字增主键自动增量的当前值。 * `CREATE_TIME`：该表的创建时间。 * `UPDATE_TIME`：该表的更新时间。 From 066871519d4432d5c1a0b8d5a7bb2771c2cea7ca Mon Sep 17 00:00:00 2001 From: Arenatlx Date: Wed, 17 Jun 2020 11:50:21 +0800 Subject: [PATCH 3/5] Update system-tables/system-table-information-schema.md Co-authored-by: Ran --- system-tables/system-table-information-schema.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/system-tables/system-table-information-schema.md b/system-tables/system-table-information-schema.md index 9aee0cb55108..79735fb6f35d 100644 --- a/system-tables/system-table-information-schema.md +++ b/system-tables/system-table-information-schema.md @@ -709,7 +709,7 @@ SHOW TABLES * `MAX_DATA_LENGTH`：最大数据长度。该值暂为 0，表示没有最大数据长度的限制。 * `INDEX_LENGTH`：索引长度。索引长度 = 统计信息中的行数 × 索引元组各列长度和，这里尚未考虑 TiKV 的副本数。 * `DATA_FREE`：空间碎片。该值暂为 0。 -* `AUTO_INCREMENT`：该表中字增主键自动增量的当前值。 +* `AUTO_INCREMENT`：该表中自增主键自动增量的当前值。 * `CREATE_TIME`：该表的创建时间。 * `UPDATE_TIME`：该表的更新时间。 * `CHECK_TIME`：该表的检查时间。 From c7e30a31cdb06ead1c38d46c66ee231d1f1be31d Mon Sep 17 00:00:00 2001 From: Arenatlx Date: Wed, 17 Jun 2020 11:50:29 +0800 Subject: [PATCH 4/5] Update system-tables/system-table-information-schema.md Co-authored-by: Ran --- system-tables/system-table-information-schema.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/system-tables/system-table-information-schema.md b/system-tables/system-table-information-schema.md index 79735fb6f35d..050c242c353f 100644 --- a/system-tables/system-table-information-schema.md +++ b/system-tables/system-table-information-schema.md @@ -701,7 +701,7 @@ SHOW TABLES * `TABLE_NAME`：表的名称。 * `TABLE_TYPE`：表的类型。 * `ENGINE`：存储引擎类型。该值暂为 ‘InnoDB’。 -* `VERSION`：版本，默认值为10。 +* `VERSION`：版本，默认值为 10。 * `ROW_FORMAT`：行格式。该值暂为 ‘Compact’。 * `TABLE_ROWS`：统计信息中该表所存的行数。 * `AVG_ROW_LENGTH`：该表中所存数据的平均行长度。平均行长度 = DATA_LENGTH / 统计信息中的行数。 From 1821db0e111f1ccca17dadcc83eb45c15706384a Mon Sep 17 00:00:00 2001 From: Arenatlx Date: Wed, 17 Jun 2020 11:50:38 +0800 Subject: [PATCH 5/5] Update system-tables/system-table-information-schema.md Co-authored-by: Ran --- system-tables/system-table-information-schema.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/system-tables/system-table-information-schema.md b/system-tables/system-table-information-schema.md index 050c242c353f..01e61af7ff24 100644 --- a/system-tables/system-table-information-schema.md +++ b/system-tables/system-table-information-schema.md @@ -423,8 +423,8 @@ SELECT * FROM session_variables LIMIT 10; `SESSION_VARIABLES` 表各列字段含义如下： -* VARIABLE_NAME：数据库中 session 级变量的名称。 -* VARIABLE_VALUE：数据库中对应该 session 变量名的具体值。 +* `VARIABLE_NAME`：数据库中 session 级变量的名称。 +* `VARIABLE_VALUE`：数据库中对应该 session 变量名的具体值。 ## SLOW_QUERY 表