Documentation Home
MySQL 8.4 Reference Manual
Related Documentation Download this Manual
PDF (US Ltr) - 40.2Mb
PDF (A4) - 40.3Mb
Man Pages (TGZ) - 262.1Kb
Man Pages (Zip) - 367.6Kb
Info (Gzip) - 4.0Mb
Info (Zip) - 4.0Mb


15.7.7.38 SHOW TABLE STATUS Statement

SHOW TABLE STATUS    [{FROM | IN}db_name]    [LIKE 'pattern' | WHEREexpr]

SHOW TABLE STATUS works likeSHOW TABLES, but provides a lot of information about each non-TEMPORARY table. You can also get this list using themysqlshow --statusdb_name command. TheLIKE clause, if present, indicates which table names to match. TheWHERE clause can be given to select rows using more general conditions, as discussed inSection 28.8, “Extensions to SHOW Statements”.

This statement also displays information about views.

SHOW TABLE STATUS output has these columns:

  • Name

    The name of the table.

  • Engine

    The storage engine for the table. SeeChapter 17,The InnoDB Storage Engine, andChapter 18,Alternative Storage Engines.

    For partitioned tables,Engine shows the name of the storage engine used by all partitions.

  • Version

    This column is unused. With the removal of.frm files in MySQL 8.0, this column now reports a hardcoded value of10, which was the last.frm file version used in MySQL 5.7.

  • Row_format

    The row-storage format (Fixed,Dynamic,Compressed,Redundant,Compact). ForMyISAM tables,Dynamic corresponds to whatmyisamchk -dvv reports asPacked.

  • Rows

    The number of rows. Some storage engines, such asMyISAM, store the exact count. For other storage engines, such asInnoDB, this value is an approximation, and may vary from the actual value by as much as 40% to 50%. In such cases, useSELECT COUNT(*) to obtain an accurate count.

    TheRows value isNULL forINFORMATION_SCHEMA tables.

    ForInnoDB tables, the row count is only a rough estimate used in SQL optimization. (This is also true if theInnoDB table is partitioned.)

  • Avg_row_length

    The average row length.

  • Data_length

    ForMyISAM,Data_length is the length of the data file, in bytes.

    ForInnoDB,Data_length is the approximate amount of space allocated for the clustered index, in bytes. Specifically, it is the clustered index size, in pages, multiplied by theInnoDB page size.

    Refer to the notes at the end of this section for information regarding other storage engines.

  • Max_data_length

    ForMyISAM,Max_data_length is maximum length of the data file. This is the total number of bytes of data that can be stored in the table, given the data pointer size used.

    Unused forInnoDB.

    Refer to the notes at the end of this section for information regarding other storage engines.

  • Index_length

    ForMyISAM,Index_length is the length of the index file, in bytes.

    ForInnoDB,Index_length is the approximate amount of space allocated for non-clustered indexes, in bytes. Specifically, it is the sum of non-clustered index sizes, in pages, multiplied by theInnoDB page size.

    Refer to the notes at the end of this section for information regarding other storage engines.

  • Data_free

    The number of allocated but unused bytes.

    InnoDB tables report the free space of the tablespace to which the table belongs. For a table located in the shared tablespace, this is the free space of the shared tablespace. If you are using multiple tablespaces and the table has its own tablespace, the free space is for only that table. Free space means the number of bytes in completely free extents minus a safety margin. Even if free space displays as 0, it may be possible to insert rows as long as new extents need not be allocated.

    For NDB Cluster,Data_free shows the space allocated on disk for, but not used by, a Disk Data table or fragment on disk. (In-memory data resource usage is reported by theData_length column.)

    For partitioned tables, this value is only an estimate and may not be absolutely correct. A more accurate method of obtaining this information in such cases is to query theINFORMATION_SCHEMAPARTITIONS table, as shown in this example:

    SELECT SUM(DATA_FREE)    FROM  INFORMATION_SCHEMA.PARTITIONS    WHERE TABLE_SCHEMA = 'mydb'    AND   TABLE_NAME   = 'mytable';

    For more information, seeSection 28.3.21, “The INFORMATION_SCHEMA PARTITIONS Table”.

  • Auto_increment

    The nextAUTO_INCREMENT value.

  • Create_time

    When the table was created.

  • Update_time

    When the data file was last updated. For some storage engines, this value isNULL. For example,InnoDB stores multiple tables in itssystem tablespace and the data file timestamp does not apply. Even withfile-per-table mode with eachInnoDB table in a separate.ibd file,change buffering can delay the write to the data file, so the file modification time is different from the time of the last insert, update, or delete. ForMyISAM, the data file timestamp is used; however, on Windows the timestamp is not updated by updates, so the value is inaccurate.

    Update_time displays a timestamp value for the lastUPDATE,INSERT, orDELETE performed onInnoDB tables that are not partitioned. For MVCC, the timestamp value reflects theCOMMIT time, which is considered the last update time. Timestamps are not persisted when the server is restarted or when the table is evicted from theInnoDB data dictionary cache.

  • Check_time

    When the table was last checked. Not all storage engines update this time, in which case, the value is alwaysNULL.

    For partitionedInnoDB tables,Check_time is alwaysNULL.

  • Collation

    The table default collation. The output does not explicitly list the table default character set, but the collation name begins with the character set name.

  • Checksum

    The live checksum value, if any.

  • Create_options

    Extra options used withCREATE TABLE.

    Create_options showspartitioned for a partitioned table.

    Create_options shows theENCRYPTION clause for file-per-table tablespaces if the table is encrypted or if the specified encryption differs from the schema encryption. The encryption clause is not shown for tables created in general tablespaces. To identify encrypted file-per-table and general tablespaces, query theINNODB_TABLESPACESENCRYPTION column.

    When creating a table withstrict mode disabled, the storage engine's default row format is used if the specified row format is not supported. The actual row format of the table is reported in theRow_format column.Create_options shows the row format that was specified in theCREATE TABLE statement.

    When altering the storage engine of a table, table options that are not applicable to the new storage engine are retained in the table definition to enable reverting the table with its previously defined options to the original storage engine, if necessary.Create_options may show retained options.

  • Comment

    The comment used when creating the table (or information as to why MySQL could not access the table information).

Notes
  • ForInnoDB tables,SHOW TABLE STATUS does not give accurate statistics except for the physical size reserved by the table. The row count is only a rough estimate used in SQL optimization.

  • ForNDB tables, the output of this statement shows appropriate values for theAvg_row_length andData_length columns, with the exception thatBLOB columns are not taken into account.

  • ForNDB tables,Data_length includes data stored in main memory only; theMax_data_length andData_free columns apply to Disk Data.

  • For NDB Cluster Disk Data tables,Max_data_length shows the space allocated for the disk part of a Disk Data table or fragment. (In-memory data resource usage is reported by theData_length column.)

  • ForMEMORY tables, theData_length,Max_data_length, andIndex_length values approximate the actual amount of allocated memory. The allocation algorithm reserves memory in large amounts to reduce the number of allocation operations.

  • For views, most columns displayed bySHOW TABLE STATUS are 0 orNULL except thatName indicates the view name,Create_time indicates the creation time, andComment saysVIEW.

Table information is also available from theINFORMATION_SCHEMATABLES table. SeeSection 28.3.38, “The INFORMATION_SCHEMA TABLES Table”.