SHOW TABLES

説明

このステートメントは、現在のdb配下のすべてのテーブルとビューを表示するために使用されます。

構文

SHOW [ FULL ] TABLES [ FROM [ <catalog_name>.]<db_name> ][ LIKE <like_condition> ]

オプションパラメータ

1. FULL

このパラメータがステートメントに追加されると、返される結果にTable_type（テーブルタイプ）、Storage_format（ストレージ形式）、Inverted_index_storage_format（転置インデックスストレージ形式）の3つの列が追加されます。

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

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

2. LIKE <like_condition>

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

戻り値

列名（Column）	型（DataType）	備考（Notes）
Tables_in_<db_name>	String	<db_name>が配置されているデータベース下のすべてのテーブルとビュー。
Table_type	String	テーブルとビューのタイプ。
Storage_format	String	テーブルとビューのストレージ形式。
Inverted_index_storage_format	String	テーブルとビューの転置インデックスストレージ形式。

アクセス制御要件

このSQLコマンドを実行するユーザーは、最低でも以下の権限を持っている必要があります：

権限（Privilege）	オブジェクト（Object）	備考（Notes）
SELECT_PRIV	テーブル（Table）、ビュー（View）	クエリ権限を持つテーブルとビューのみ表示できます。

使用上の注意

• ステートメントでFROM句が指定されていない場合、実行には対応するデータベースを使用する必要があります。

例

• DB下のすべてのテーブルを表示

  SHOW TABLES;

  +---------------------------------+
  | Tables_in_demo                  |
  +---------------------------------+
  | ads_client_biz_aggr_di_20220419 |
  | cmy1                            |
  | cmy2                            |
  | intern_theme                    |
  | left_table                      |
  +---------------------------------+

• テーブル名による曖昧検索

  SHOW TABLES LIKE '%cm%'

  +----------------+
  | Tables_in_demo |
  +----------------+
  | cmy1           |
  | cmy2           |
  +----------------+

• FULLを使用してdb配下のテーブルとビューをクエリする

  SHOW FULL TABLES

  +----------------+------------+----------------+-------------------------------+
  | Tables_in_demo | Table_type | Storage_format | Inverted_index_storage_format |
  +----------------+------------+----------------+-------------------------------+
  | test_table     | BASE TABLE | V2             | V1                            |
  | test_view      | VIEW       | NONE           | NONE                          |
  +----------------+------------+----------------+-------------------------------+