MySQL :: MySQL 9.0 参考手册 :: 28.3.38 INFORMATION_SCHEMA TABLES 表

版本 9.0

8.4 当前
8.0
5.7

8.0 日语

MySQL 9.0 参考手册 / ... / INFORMATION_SCHEMA TABLES 表

28.3.38 INFORMATION_SCHEMA TABLES 表

TABLES 表提供有关数据库中表的信息。

TABLES 中表示表统计信息的列保存缓存的值。 information_schema_stats_expiry 系统变量定义缓存的表统计信息过期前的时间段。默认值为 86400 秒（24 小时）。如果没有缓存的统计信息或统计信息已过期，则在查询表统计信息列时，将从存储引擎检索统计信息。要随时更新给定表的缓存值，请使用 ANALYZE TABLE。要始终直接从存储引擎检索最新统计信息，请将 information_schema_stats_expiry 设置为 0。有关更多信息，请参阅第 10.2.3 节，“优化 INFORMATION_SCHEMA 查询”。

注意

如果启用了 innodb_read_only 系统变量，则 ANALYZE TABLE 可能会失败，因为它无法更新数据字典中使用 InnoDB 的统计信息表。对于更新键分布的 ANALYZE TABLE 操作，即使该操作更新了表本身（例如，如果是 MyISAM 表），也可能会发生失败。要获取更新的分布统计信息，请设置 information_schema_stats_expiry=0。

TABLES 表包含以下列：

TABLE_CATALOG
表所属目录的名称。此值始终为 def。
TABLE_SCHEMA
表所属模式（数据库）的名称。
TABLE_NAME
表的名称。
TABLE_TYPE
表的类型为 BASE TABLE，视图的类型为 VIEW，INFORMATION_SCHEMA 表的类型为 SYSTEM VIEW。
TABLES 表未列出 TEMPORARY 表。
ENGINE
表的存储引擎。请参阅第 17 章，InnoDB 存储引擎，以及第 18 章，其他存储引擎。
对于分区表，ENGINE 显示所有分区使用的存储引擎的名称。
VERSION
此列未使用。随着 MySQL 8.0 中删除了 .frm 文件，此列现在报告硬编码值 10，这是 MySQL 5.7 中使用的最后一个 .frm 文件版本。
ROW_FORMAT
行存储格式（Fixed、Dynamic、Compressed、Redundant、Compact）。对于 MyISAM 表，Dynamic 对应于 myisamchk -dvv 报告为 Packed 的内容。
TABLE_ROWS
行数。某些存储引擎（例如 MyISAM）存储确切计数。对于其他存储引擎（例如 InnoDB），此值是一个近似值，可能与实际值相差 40% 到 50%。在这种情况下，请使用 SELECT COUNT(*) 获取准确计数。
对于 INFORMATION_SCHEMA 表，TABLE_ROWS 为 NULL。
对于 InnoDB 表，行计数只是 SQL 优化中使用的粗略估计值。（如果 InnoDB 表已分区，也是如此。）
AVG_ROW_LENGTH
平均行长度。
DATA_LENGTH
对于 MyISAM，DATA_LENGTH 是数据文件的长度（以字节为单位）。
对于 InnoDB，DATA_LENGTH 是为聚集索引分配的空间的近似值（以字节为单位）。具体来说，它是聚集索引大小（以页为单位）乘以 InnoDB 页面大小。
有关其他存储引擎的信息，请参阅本节末尾的注释。
MAX_DATA_LENGTH
对于 MyISAM，MAX_DATA_LENGTH 是数据文件的最大长度。考虑到使用的数据指针大小，这是可以存储在表中的数据的总字节数。
InnoDB 未使用。
有关其他存储引擎的信息，请参阅本节末尾的注释。
INDEX_LENGTH
对于 MyISAM，INDEX_LENGTH 是索引文件的长度（以字节为单位）。
对于 InnoDB，INDEX_LENGTH 是为非聚集索引分配的大致空间量（以字节为单位）。具体来说，它是页面中非聚集索引大小的总和乘以 InnoDB 页面大小。
有关其他存储引擎的信息，请参阅本节末尾的注释。
DATA_FREE
已分配但未使用的字节数。
InnoDB 表报告表所属表空间的可用空间。对于位于共享表空间中的表，这是共享表空间的可用空间。如果您使用多个表空间并且该表有自己的表空间，则可用空间仅适用于该表。可用空间是指完全空闲的区段中的字节数减去安全边际。即使可用空间显示为 0，只要不需要分配新的区段，仍然可以插入行。
对于 NDB 群集，DATA_FREE 显示为磁盘数据表或磁盘上的片段分配但未使用的磁盘空间。（内存数据资源使用情况由 DATA_LENGTH 列报告。）
对于分区表，此值只是一个估计值，可能不完全准确。在这种情况下，获取此信息的更准确方法是查询 INFORMATION_SCHEMA PARTITIONS 表，如本例所示
```
SELECT SUM(DATA_FREE)
    FROM  INFORMATION_SCHEMA.PARTITIONS
    WHERE TABLE_SCHEMA = 'mydb'
    AND   TABLE_NAME   = 'mytable';
```
有关更多信息，请参阅第 28.3.21 节“INFORMATION_SCHEMA PARTITIONS 表”。
AUTO_INCREMENT
下一个 AUTO_INCREMENT 值。
CREATE_TIME
创建表的时间。
UPDATE_TIME
上次更新表的时间。对于某些存储引擎，此值为 NULL。即使在每个 InnoDB 表位于单独的 .ibd 文件中的每个表一个文件模式下，更改缓冲也会延迟写入数据文件，因此文件修改时间与上次插入、更新或删除的时间不同。对于 MyISAM，使用数据文件时间戳；但是，在 Windows 上，时间戳不会因更新而更新，因此该值不准确。
UPDATE_TIME 显示未分区的 InnoDB 表上执行的最后一次 UPDATE、INSERT 或 DELETE 的时间戳值。对于 MVCC，时间戳值反映 COMMIT 时间，该时间被视为最后更新时间。重新启动服务器或从 InnoDB 数据字典缓存中逐出表时，不会保留时间戳。
CHECK_TIME
上次检查表的时间。并非所有存储引擎都会更新此时间，在这种情况下，该值始终为 NULL。
对于分区的 InnoDB 表，CHECK_TIME 始终为 NULL。
TABLE_COLLATION
表的默认排序规则。输出没有明确列出表的默认字符集，但排序规则名称以字符集名称开头。
CHECKSUM
实时校验和值（如果有）。
CREATE_OPTIONS
与 CREATE TABLE 一起使用的额外选项。
对于分区表，CREATE_OPTIONS 显示 partitioned。
CREATE_OPTIONS 显示为在每个表一个文件表空间中创建的表指定的 ENCRYPTION 子句。如果表已加密或指定的加密与架构加密不同，则它会显示每个表一个文件表空间的加密子句。对于在通用表空间中创建的表，不会显示加密子句。要标识加密的每个表一个文件和通用表空间，请查询 INNODB_TABLESPACES ENCRYPTION 列。
在禁用严格模式的情况下创建表时，如果指定的行格式不受支持，则使用存储引擎的默认行格式。表的实际行格式在 ROW_FORMAT 列中报告。CREATE_OPTIONS 显示在 CREATE TABLE 语句中指定的行格式。
更改表的存储引擎时，不适用于新存储引擎的表选项会保留在表定义中，以便在必要时能够使用先前定义的选项将表恢复到原始存储引擎。CREATE_OPTIONS 列可能会显示保留的选项。
TABLE_COMMENT
创建表时使用的注释（或有关 MySQL 无法访问表信息的原因的信息）。

备注

对于 NDB 表，此语句的输出显示 AVG_ROW_LENGTH 和 DATA_LENGTH 列的适当值，但 BLOB 列除外。
对于 NDB 表，DATA_LENGTH 仅包括存储在主内存中的数据；MAX_DATA_LENGTH 和 DATA_FREE 列适用于磁盘数据。
对于 NDB 群集磁盘数据表，MAX_DATA_LENGTH 显示为磁盘数据表或片段的磁盘部分分配的空间。（内存数据资源使用情况由 DATA_LENGTH 列报告。）
对于 MEMORY 表，DATA_LENGTH、MAX_DATA_LENGTH 和 INDEX_LENGTH 值近似于实际分配的内存量。分配算法会预留大量内存，以减少分配操作的次数。
对于视图，大多数 TABLES 列为 0 或 NULL，但 TABLE_NAME 表示视图名称，CREATE_TIME 表示创建时间，TABLE_COMMENT 表示 VIEW。

还可以从 SHOW TABLE STATUS 和 SHOW TABLES 语句获取表信息。请参阅第 15.7.7.37 节“SHOW TABLE STATUS 语句” 和第 15.7.7.38 节“SHOW TABLES 语句”。以下语句等效

SELECT
    TABLE_NAME, ENGINE, VERSION, 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
  FROM INFORMATION_SCHEMA.TABLES
  WHERE table_schema = 'db_name'
  [AND table_name LIKE 'wild']

SHOW TABLE STATUS
  FROM db_name
  [LIKE 'wild']

以下语句等效

SELECT
  TABLE_NAME, TABLE_TYPE
  FROM INFORMATION_SCHEMA.TABLES
  WHERE table_schema = 'db_name'
  [AND table_name LIKE 'wild']

SHOW FULL TABLES
  FROM db_name
  [LIKE 'wild']