スキーマ内のテーブルのリストと、いくつかのテーブル属性を表示します。
各出力行は、データベース名、スキーマ名、テーブル名、テーブルタイプ、テーブル ACL、および注釈で構成されます。これらの属性の詳細については、「SVV_ALL_TABLES」を参照してください。
SHOW TABLES コマンドの結果のテーブル数が 10,000 を超える場合は、エラーが返されます。
必要なアクセス許可
Amazon Redshift スキーマのテーブルを表示するには、現在のユーザーが次の条件のうち 1 つを満たす必要があります。
スーパーユーザーであること。
テーブルの所有者であること。
親スキーマに対する USAGE 権限が付与され、テーブルに対する SELECT 権限またはテーブル内の任意の列に対する SELECT 権限が付与されていること。
構文
SHOW TABLES FROM SCHEMA database_name.schema_name [LIKE 'filter_pattern'] [LIMIT row_limit ]
パラメータ
- database_name
-
一覧表示するテーブルが含まれているデータベースの名前。
AWS Glue Data Catalog でテーブルを表示するには、データベース名として (
awsdatacatalog) を指定し、システム設定data_catalog_auto_mountがtrueに設定されていることを確認します。詳細については、「ALTER SYSTEM」を参照してください。 - schema_name
-
一覧表示するテーブルが含まれているスキーマの名前。
AWS Glue Data Catalog テーブルを表示するには、スキーマ名として AWS Glue データベース名を指定します。
- filter_pattern
-
テーブル名とマッチングするパターンが含まれる有効な UTF-8 文字式。LIKE オプションでは、以下のパターンマッチングメタ文字をサポートする、大文字と小文字を区別したマッチングを行います。
メタ文字 説明 %ゼロ個以上の任意の文字シーケンスをマッチングします。 _任意の 1 文字をマッチングします。 filter_pattern にメタ文字が含まれていない場合、パターンは文字列そのものを表すだけです。この場合、LIKE は等号演算子と同じ働きをします。
- row_limit
-
返される行の最大数。row_limit には、0～10,000 の値を指定できます。
例
次の例は、スキーマ public にある、dev という名前の Amazon Redshift データベース内のテーブルを示しています。
SHOW TABLES FROM SCHEMA dev.public;
database_name | schema_name | table_name | table_type | table_acl | remarks
---------------+-------------+------------+------------+-----------+---------
dev | public | tb | TABLE | |
dev | public | tb2 | TABLE | |
dev | public | tb3 | TABLE | |
次の例は、スキーマ batman にある、awsdatacatalog という AWS Glue Data Catalog データベース内のテーブルを示しています。
SHOW TABLES FROM SCHEMA awsdatacatalog.batman;
database_name | schema_name | table_name | table_type | table_acl | remarks
----------------+-------------+------------------+------------+-----------+---------
awsdatacatalog | batman | nation | EXTERNAL | |
awsdatacatalog | batman | part | EXTERNAL | |
awsdatacatalog | batman | partsupp | EXTERNAL | |
awsdatacatalog | batman | region | EXTERNAL | |
awsdatacatalog | batman | supplier | EXTERNAL | |
awsdatacatalog | batman | automount_nation | EXTERNAL | |
