SHOW COLUMNS

テーブル内の列のリストと、いくつかの列属性を表示します。

各出力行は、データベース名、スキーマ名、テーブル名、列名、序数位置、列のデフォルト、NULL 指定可、データ型、最大文字長、数値精度、および注釈をカンマで区切ったリストで構成されます。これらの属性の詳細については、「SVV_ALL_COLUMNS」を参照してください。

SHOW COLUMNS コマンドの結果が 10,000 列を超える場合は、エラーが返されます。

構文

SHOW COLUMNS FROM TABLE database_name.schema_name.table_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 データベース名をスキーマ名として指定します。

table_name

一覧表示する列が含まれているテーブルの名前。

filter_pattern

テーブル名とマッチングするパターンが含まれる有効な UTF-8 文字式。LIKE オプションでは、以下のパターンマッチングメタ文字をサポートする、大文字と小文字を区別したマッチングを行います。

メタ文字	説明
%	ゼロ個以上の任意の文字シーケンスをマッチングします。
_	任意の 1 文字をマッチングします。

filter_pattern にメタ文字が含まれていない場合、パターンは文字列そのものを表すだけです。この場合、LIKE は等号演算子と同じ働きをします。

row_limit

返される行の最大数。row_limit には、0～10,000 の値を指定できます。

例

次の例は、スキーマ public とテーブル tb にある、dev という Amazon Redshiftデータベース内の列を示しています。

SHOW COLUMNS FROM TABLE dev.public.tb;

 database_name | schema_name | table_name | column_name | ordinal_position | column_default | is_nullable | data_type | character_maximum_length | numeric_precision | remarks 
---------------+-------------+------------+-------------+------------------+----------------+-------------+-----------+--------------------------+-------------------+---------
 dev           | public      | tb         | col         |                1 |                | YES         | integer   |                          |                32 |

次の例は、スキーマ batman とテーブル nation にある、awsdatacatalog という AWS Glue Data Catalog データベース内のテーブルを示しています。出力は、2 行に制限されます。

SHOW COLUMNS FROM TABLE awsdatacatalog.batman.nation LIMIT 2;

 database_name  | schema_name | table_name | column_name | ordinal_position | column_default | is_nullable | data_type | character_maximum_length | numeric_precision | remarks 
----------------+-------------+------------+-------------+------------------+----------------+-------------+-----------+--------------------------+-------------------+---------
 awsdatacatalog | batman      | nation     | n_nationkey |                1 |                |             | integer   |                          |                   | 
 awsdatacatalog | batman      | nation     | n_name      |                2 |                |             | character |                          |                   |