SHOW TABLE STATUS

説明

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

構文

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

オプションパラメータ

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

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

2. LIKE <like_condition>

LIKE句でテーブル名に基づいたあいまい検索を実行できます。

戻り値

Column	DataType	Notes
Name	String	テーブル名
Engine	String	テーブルのストレージエンジン
Version	String	バージョン
Row_format	String	行フォーマット。MyISAMエンジンの場合、Dynamic、Fixed、またはCompressedになります。Dynamic行はVarcharやBlob型フィールドのように可変長です。Fixed行はCharやInteger型フィールドのように固定長です。
Rows	String	テーブルの行数。非トランザクションテーブルの場合、この値は正確です。トランザクションエンジンの場合、この値は通常推定値です。
Avg_row_length	Integer	1行あたりの平均バイト数
Data_length	Integer	テーブル全体のデータ量（バイト単位）
Max_data_length	Integer	テーブルが保持できるデータの最大量
Index_length	Integer	インデックスが占有するディスク容量
Data_free	Integer	MyISAMエンジンの場合、割り当てられているが現在使用されていない領域を識別し、削除された行の領域も含みます。
Auto_increment	Integer	次のAuto_incrementの値
Create_time	Datetime	テーブルの作成時刻
Update_time	Datetime	テーブルの最終更新時刻
Check_time	Datetime	check tableまたはmyisamchkツールを使用してテーブルを最後にチェックした時刻
Collation	String	テーブルのデフォルト文字セット、現在はutf-8のみをサポート
Checksum	String	有効な場合、テーブル全体の内容に対して計算されたチェックサム
Create_options	String	テーブル作成時の他のすべてのオプションを指します
Comment	String	テーブルコメント

アクセス制御要件

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

Privilege	Object	Notes
ADMIN_PRIV	Table, View	現在、この操作を実行するにはADMIN権限のみをサポートしています

使用上の注意

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

例

• 現在のデータベースの全テーブル情報を表示

  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を含む名前のテーブルに関する情報を表示する

  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           |         |
  +------------+--------+---------+------------+------+----------------+-------------+-----------------+--------------+-----------+----------------+---------------------+---------------------+------------+-----------+----------+----------------+---------+