メインコンテンツまでスキップ
バージョン: 4.x

SHOW TABLE STATUS

説明​

このステートメントは、Tableまたはビューに関する情報を表示するために使用されます。

構文​

SHOW TABLE STATUS [ FROM [ <catalog_name>.]<db_name> ] [ LIKE <like_condition> ]

オプションパラメータ​

1. FROM [ <catalog_name>.]<db_name>

FROM句でクエリ対象のカタログ名とデータベース名を指定できます。

2. LIKE <like_condition>

LIKE句はTable名に基づいてファジー検索を実行できます。

戻り値​

ColumnDataType注釈
NameStringTable名
EngineStringTableのストレージエンジン
VersionStringバージョン
Row_formatString行フォーマット。MyISAMエンジンの場合、Dynamic、Fixed、またはCompressedになる場合があります。Dynamic行はVarcharやBlob型フィールドのような可変長です。Fixed行はCharやInteger型フィールドのような固定長です。
RowsStringTableの行数。非トランザクショナルTableの場合、この値は正確で、トランザクショナルエンジンの場合、この値は通常推定値です。
Avg_row_lengthInteger1行あたりの平均バイト数
Data_lengthIntegerTable全体のデータ量（バイト単位）
Max_data_lengthIntegerTableが保持できる最大データ量
Index_lengthIntegerインデックスが占有するディスク容量
Data_freeIntegerMyISAMエンジンの場合、割り当てられているが現在使用されていない領域を識別し、削除された行の領域も含みます。
Auto_incrementInteger次のAuto_incrementの値
Create_timeDatetimeTableの作成時刻
Update_timeDatetimeTableの最終更新時刻
Check_timeDatetimecheck tableまたはmyisamchkツールを使用してTableをチェックした最終時刻
CollationStringTableのデフォルト文字セット、現在はutf-8のみサポート
ChecksumString有効な場合、Table全体の内容に対して計算されたチェックサム
Create_optionsStringTable作成時のその他すべてのオプションを指します
CommentStringTableコメント

アクセス制御要件​

このSQLコマンドを実行するユーザーは、少なくとも以下の権限を持つ必要があります：

PrivilegeObject注釈
ADMIN_PRIVTable, View現在、この操作を実行するにはADMIN権限のみサポートしています

使用上の注意​

  • このステートメントは主にMySQL構文との互換性のために使用されます。現在、Commentなどの少量の情報のみが表示されます。

例​

  • 現在のデータベース内のすべてのTableに関する情報を表示

    SHOW TABLE STATUS
    +------------+--------+---------+------------+------+----------------+-------------+-----------------+--------------+-----------+----------------+---------------------+---------------------+------------+-----------+----------+----------------+---------+
    | Name       | Engine | Version | Row_format | Rows | Avg_row_length | Data_length | Max_data_length | Index_length | Data_free | Auto_increment | Create_time         | Update_time         | Check_time | Collation | Checksum | Create_options | Comment |
    +------------+--------+---------+------------+------+----------------+-------------+-----------------+--------------+-----------+----------------+---------------------+---------------------+------------+-----------+----------+----------------+---------+
    | test_table | Doris  |    NULL | NULL       |    0 |              0 |           0 |            NULL |         NULL |      NULL |           NULL | 2025-01-22 11:45:36 | 2025-01-22 11:45:36 | NULL       | utf-8     |     NULL | NULL           |         |
    | test_view  | View   |    NULL | NULL       |    0 |              0 |           0 |            NULL |         NULL |      NULL |           NULL | 2025-01-22 11:46:32 | NULL                | NULL       | utf-8     |     NULL | NULL           |         |
    +------------+--------+---------+------------+------+----------------+-------------+-----------------+--------------+-----------+----------------+---------------------+---------------------+------------+-----------+----------+----------------+---------+

  • 指定されたデータベース配下で、名前にexampleを含むTableに関する情報を表示する

    SHOW TABLE STATUS FROM db LIKE "%test%"
    +------------+--------+---------+------------+------+----------------+-------------+-----------------+--------------+-----------+----------------+---------------------+---------------------+------------+-----------+----------+----------------+---------+
    | Name       | Engine | Version | Row_format | Rows | Avg_row_length | Data_length | Max_data_length | Index_length | Data_free | Auto_increment | Create_time         | Update_time         | Check_time | Collation | Checksum | Create_options | Comment |
    +------------+--------+---------+------------+------+----------------+-------------+-----------------+--------------+-----------+----------------+---------------------+---------------------+------------+-----------+----------+----------------+---------+
    | test_table | Doris  |    NULL | NULL       |    0 |              0 |           0 |            NULL |         NULL |      NULL |           NULL | 2025-01-22 11:45:36 | 2025-01-22 11:45:36 | NULL       | utf-8     |     NULL | NULL           |         |
    | test_view  | View   |    NULL | NULL       |    0 |              0 |           0 |            NULL |         NULL |      NULL |           NULL | 2025-01-22 11:46:32 | NULL                | NULL       | utf-8     |     NULL | NULL           |         |
    +------------+--------+---------+------------+------+----------------+-------------+-----------------+--------------+-----------+----------------+---------------------+---------------------+------------+-----------+----------+----------------+---------+