MySQL :: MySQL 8.4 参考手册 :: 28.3.15 INFORMATION_SCHEMA FILES 表

版本 8.4

8.0 日语

MySQL 8.4 参考手册 / ... / INFORMATION_SCHEMA FILES 表

28.3.15 INFORMATION_SCHEMA FILES 表

FILES 表提供了有关存储 MySQL 表空间数据的文件的信息。

FILES 表提供了有关 InnoDB 数据文件的信息。在 NDB 集群中，此表还提供了有关存储 NDB 集群磁盘数据表的文件的信息。有关特定于 InnoDB 的更多信息，请参阅本节后面的 InnoDB 注释；有关特定于 NDB 集群的更多信息，请参阅 NDB 注释。

FILES 表包含以下列

FILE_ID
对于 InnoDB：表空间 ID，也称为 space_id 或 fil_space_t::id。
对于 NDB：文件标识符。 FILE_ID 列值是自动生成的。
FILE_NAME
对于 InnoDB：数据文件的名称。每个表和通用表空间都有一个 .ibd 文件名扩展名。撤消表空间以 undo 为前缀。系统表空间以 ibdata 为前缀。全局临时表空间以 ibtmp 为前缀。文件名包含文件路径，该路径可能相对于 MySQL 数据目录（datadir 系统变量的值）。
对于 NDB：由 CREATE LOGFILE GROUP 或 ALTER LOGFILE GROUP 创建的撤消日志文件的名称，或由 CREATE TABLESPACE 或 ALTER TABLESPACE 创建的数据文件的名称。在 NDB 8.4 中，文件名显示为相对路径；对于撤消日志文件，此路径相对于目录 DataDir/ndb_NodeId_fs/LG；对于数据文件，它相对于目录 DataDir/ndb_NodeId_fs/TS。这意味着，例如，使用 ALTER TABLESPACE ts ADD DATAFILE 'data_2.dat' INITIAL SIZE 256M 创建的数据文件的名称显示为 ./data_2.dat。
FILE_TYPE
对于 InnoDB：表空间文件类型。 InnoDB 文件有三种可能的类型。 TABLESPACE 是任何系统、通用或每个表表空间文件的文件类型，这些文件存储表、索引或其他形式的用户数据。 TEMPORARY 是临时表空间的文件类型。 UNDO LOG 是撤消表空间的文件类型，它存储撤消记录。
对于 NDB：值之一为 UNDO LOG 或 DATAFILE。
TABLESPACE_NAME
与文件关联的表空间的名称。
对于 InnoDB：通用表空间名称与创建时指定的名称相同。每个表表空间的名称显示为以下格式：schema_name/table_name。 InnoDB 系统表空间名称为 innodb_system。全局临时表空间名称为 innodb_temporary。默认撤消表空间名称为 innodb_undo_001 和 innodb_undo_002。用户创建的撤消表空间名称与创建时指定的名称相同。
TABLE_CATALOG
此值始终为空。
TABLE_SCHEMA
这始终为 NULL。
TABLE_NAME
这始终为 NULL。
LOGFILE_GROUP_NAME
对于 InnoDB：这始终为 NULL。
对于 NDB：日志文件或数据文件所属的日志文件组的名称。
LOGFILE_GROUP_NUMBER
对于 InnoDB：这始终为 NULL。
对于 NDB：对于磁盘数据撤消日志文件，日志文件所属的日志文件组的自动生成 ID 号。这与 ndbinfo.dict_obj_info 表中显示的 id 列值以及 ndbinfo.logspaces 和 ndbinfo.logspaces 表中此撤消日志文件的 log_id 列值相同。
ENGINE
对于 InnoDB：此值始终为 InnoDB。
对于 NDB：此值始终为 ndbcluster。
FULLTEXT_KEYS
这始终为 NULL。
DELETED_ROWS
这始终为 NULL。
UPDATE_COUNT
这始终为 NULL。
FREE_EXTENTS
对于 InnoDB：当前数据文件中完全空闲的扩展数量。
对于 NDB：文件尚未使用的扩展数量。
TOTAL_EXTENTS
对于 InnoDB：当前数据文件中使用的完整扩展数量。文件末尾的任何部分扩展都不计算在内。
对于 NDB：分配给文件的扩展总数。
EXTENT_SIZE
对于 InnoDB：对于页面大小为 4KB、8KB 或 16KB 的文件，扩展大小为 1048576（1MB）。对于页面大小为 32KB 的文件，扩展大小为 2097152 字节（2MB），对于页面大小为 64KB 的文件，扩展大小为 4194304（4MB）。FILES 不报告 InnoDB 页面大小。页面大小由 innodb_page_size 系统变量定义。扩展大小信息也可以从 INNODB_TABLESPACES 表中获取，其中 FILES.FILE_ID = INNODB_TABLESPACES.SPACE。
对于 NDB：文件的扩展大小（以字节为单位）。
INITIAL_SIZE
对于 InnoDB：文件的初始大小（以字节为单位）。
对于 NDB：文件的字节大小。这与用于创建文件的 CREATE LOGFILE GROUP、ALTER LOGFILE GROUP、CREATE TABLESPACE 或 ALTER TABLESPACE 语句中使用的 INITIAL_SIZE 子句中的值相同。
MAXIMUM_SIZE
对于 InnoDB：文件中允许的最大字节数。除预定义系统表空间数据文件外，所有数据文件的该值为 NULL。最大系统表空间文件大小由 innodb_data_file_path 定义。最大全局临时表空间文件大小由 innodb_temp_data_file_path 定义。预定义系统表空间数据文件的 NULL 值表示未明确定义文件大小限制。
对于 NDB：此值始终与 INITIAL_SIZE 值相同。
AUTOEXTEND_SIZE
表空间的自动扩展大小。对于 NDB，AUTOEXTEND_SIZE 始终为 NULL。
CREATION_TIME
这始终为 NULL。
LAST_UPDATE_TIME
这始终为 NULL。
LAST_ACCESS_TIME
这始终为 NULL。
RECOVER_TIME
这始终为 NULL。
TRANSACTION_COUNTER
这始终为 NULL。
VERSION
对于 InnoDB：这始终为 NULL。
对于 NDB：文件的版本号。
ROW_FORMAT
对于 InnoDB：这始终为 NULL。
对于 NDB：FIXED 或 DYNAMIC 之一。
TABLE_ROWS
这始终为 NULL。
AVG_ROW_LENGTH
这始终为 NULL。
DATA_LENGTH
这始终为 NULL。
MAX_DATA_LENGTH
这始终为 NULL。
INDEX_LENGTH
这始终为 NULL。
DATA_FREE
对于 InnoDB：整个表空间的可用空间总量（以字节为单位）。预定义系统表空间（包括系统表空间和临时表表空间）可能具有一个或多个数据文件。
对于 NDB：这始终为 NULL。
CREATE_TIME
这始终为 NULL。
UPDATE_TIME
这始终为 NULL。
CHECK_TIME
这始终为 NULL。
CHECKSUM
这始终为 NULL。
STATUS
对于 InnoDB：此值默认情况下为 NORMAL。 InnoDB 每表文件表空间可能会报告 IMPORTING，这表示表空间尚不可用。
对于 NDB：对于 NDB Cluster 磁盘数据文件，此值始终为 NORMAL。

EXTRA

对于 InnoDB：这始终为 NULL。

对于 NDB：对于撤消日志文件，此列显示撤消日志缓冲区大小；对于数据文件，它始终为 NULL。接下来的几段将提供更详细的解释。

NDB 在集群中的每个数据节点上存储每个数据文件和每个撤消日志文件的副本。 FILES 表包含每个此类文件的行。假设您在具有四个数据节点的 NDB 集群上运行以下两个语句

CREATE LOGFILE GROUP mygroup
    ADD UNDOFILE 'new_undo.dat'
    INITIAL_SIZE 2G
    ENGINE NDBCLUSTER;

CREATE TABLESPACE myts
    ADD DATAFILE 'data_1.dat'
    USE LOGFILE GROUP mygroup
    INITIAL_SIZE 256M
    ENGINE NDBCLUSTER;

成功运行这两个语句后，您应该看到类似于这里显示的针对 FILES 表的查询结果

mysql> SELECT LOGFILE_GROUP_NAME, FILE_TYPE, EXTRA
    ->     FROM INFORMATION_SCHEMA.FILES
    ->     WHERE ENGINE = 'ndbcluster';

+--------------------+-----------+--------------------------+
| LOGFILE_GROUP_NAME | FILE_TYPE | EXTRA                    |
+--------------------+-----------+--------------------------+
| mygroup            | UNDO LOG  | UNDO_BUFFER_SIZE=8388608 |
| mygroup            | DATAFILE  | NULL                     |
+--------------------+-----------+--------------------------+

说明

FILES 是一个非标准的 INFORMATION_SCHEMA 表。
您必须具有 PROCESS 权限才能查询此表。

InnoDB 说明

以下说明适用于 InnoDB 数据文件。

FILES 报告的信息是从打开文件的 InnoDB 内存缓存中获取的，而 INNODB_DATAFILES 从 InnoDB SYS_DATAFILES 内部数据字典表中获取其数据。
FILES 提供的信息包括全局临时表空间信息，该信息在 InnoDB SYS_DATAFILES 内部数据字典表中不可用，因此也不包括在 INNODB_DATAFILES 中。
当存在单独的撤消表空间时，撤消表空间信息将显示在 FILES 中，因为它们在 MySQL 8.4 中默认存在。

以下查询将返回与 InnoDB 表空间相关的所有 FILES 表信息。

SELECT
  FILE_ID, FILE_NAME, FILE_TYPE, TABLESPACE_NAME, FREE_EXTENTS,
  TOTAL_EXTENTS, EXTENT_SIZE, INITIAL_SIZE, MAXIMUM_SIZE,
  AUTOEXTEND_SIZE, DATA_FREE, STATUS
FROM INFORMATION_SCHEMA.FILES
WHERE ENGINE='InnoDB'\G

NDB 说明

FILES 表提供有关磁盘数据文件的信息；您不能使用它来确定磁盘空间分配或各个 NDB 表的可用性。但是，可以使用 ndb_desc 查看在磁盘上存储数据的每个 NDB 表分配了多少空间，以及该表在磁盘上存储数据时还剩下多少可用空间。
FILES 表中包含的大部分信息也可以在 ndbinfo files 表中找到。
CREATION_TIME、LAST_UPDATE_TIME 和 LAST_ACCESSED 值由操作系统报告，而不是由 NDB 存储引擎提供。在操作系统没有提供值的情况下，这些列将显示 NULL。
TOTAL EXTENTS 和 FREE_EXTENTS 列之间的差值是文件当前使用的扩展数量
```
SELECT TOTAL_EXTENTS - FREE_EXTENTS AS extents_used
    FROM INFORMATION_SCHEMA.FILES
    WHERE FILE_NAME = './myfile.dat';
```
要近似估计文件使用的磁盘空间量，请将该差值乘以 EXTENT_SIZE 列的值，该值以字节为单位给出文件扩展的大小
```
SELECT (TOTAL_EXTENTS - FREE_EXTENTS) * EXTENT_SIZE AS bytes_used
    FROM INFORMATION_SCHEMA.FILES
    WHERE FILE_NAME = './myfile.dat';
```
同样，您可以通过将 FREE_EXTENTS 乘以 EXTENT_SIZE 来估计给定文件中剩余的可用空间量
```
SELECT FREE_EXTENTS * EXTENT_SIZE AS bytes_free
    FROM INFORMATION_SCHEMA.FILES
    WHERE FILE_NAME = './myfile.dat';
```
重要

前面查询生成的字节值仅为近似值，其精度与 EXTENT_SIZE 的值成反比。也就是说，EXTENT_SIZE 越大，近似值就越不准确。

同样重要的是要记住，一旦使用扩展，就无法在不删除它所属的数据文件的情况下释放它。这意味着从磁盘数据表中删除数据不会释放磁盘空间。
可以在 CREATE TABLESPACE 语句中设置扩展大小。有关更多信息，请参见第 15.1.21 节，“CREATE TABLESPACE 语句”。
您可以使用 ndb_desc 实用程序获取有关磁盘数据表空间的信息。有关更多信息，请参见第 25.6.11.1 节，“NDB Cluster 磁盘数据对象”，以及 ndb_desc 的描述。
有关创建、删除和获取有关 NDB Cluster 磁盘数据对象的更多信息和示例，请参见第 25.6.11 节，“NDB Cluster 磁盘数据表”。

PREV HOME UP NEXT