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を含むテーブルの情報を表示する
```sql
SHOW TABLE STATUS FROM db LIKE "%test%"
```
```text
+------------+--------+---------+------------+------+----------------+-------------+-----------------+--------------+-----------+----------------+---------------------+---------------------+------------+-----------+----------+----------------+---------+
| 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 | |
+------------+--------+---------+------------+------+----------------+-------------+-----------------+--------------+-----------+----------------+---------------------+---------------------+------------+-----------+----------+----------------+---------+
```
