SHOW COLUMNS - Amazon Redshift

Amazon Redshift は、パッチ 198 以降、新しい Python UDF の作成をサポートしなくなります。既存の Python UDF は、2026 年 6 月 30 日まで引き続き機能します。詳細については、ブログ記事を参照してください。

SHOW COLUMNS

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

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

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

必要なアクセス許可

Amazon Redshift テーブルの列を表示するには、現在のユーザーが次の条件のうち 1 つを満たす必要があります。

  • スーパーユーザーであること。

  • テーブルの所有者であること。

  • 親スキーマに対する USAGE 権限が付与され、テーブルに対する SELECT 権限または列に対する SELECT 権限が付与されていること。

構文

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 の値を指定できます。

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

SHOW COLUMNS FROM TABLE demo_schema.compound_sort_table; database_name | schema_name | table_name | column_name | ordinal_position | column_default | is_nullable | data_type | character_maximum_length | numeric_precision | numeric_scale | remarks | sort_key_type | sort_key | dist_key | encoding | collation ---------------+-------------+---------------------+-------------+------------------+----------------+-------------+-------------------+--------------------------+-------------------+---------------+---------+---------------+----------+----------+----------+----------- demo_db | demo_schema | compound_sort_table | id | 1 | | YES | integer | | 32 | 0 | | COMPOUND | 1 | 1 | delta32k | demo_db | demo_schema | compound_sort_table | name | 2 | | YES | character varying | 50 | | | | COMPOUND | 2 | | lzo | default demo_db | demo_schema | compound_sort_table | date_col | 3 | | YES | date | | | | | | 0 | | delta | demo_db | demo_schema | compound_sort_table | amount | 4 | | YES | numeric | | 10 | 2 | | | 0 | | mostly16 |

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

SHOW COLUMNS FROM TABLE second_db.public.t22; database_name | schema_name | table_name | column_name | ordinal_position | column_default | is_nullable | data_type | character_maximum_length | numeric_precision | numeric_scale | remarks | sort_key_type | sort_key | dist_key | encoding | collation ---------------+-------------+------------+-------------+------------------+----------------+-------------+-----------------------------+--------------------------+-------------------+---------------+---------+---------------+----------+----------+----------+----------- second_db | public | t22 | col1 | 1 | | YES | integer | | 32 | 0 | | INTERLEAVED | -1 | | mostly8 | second_db | public | t22 | col2 | 2 | | YES | character varying | 100 | | | | INTERLEAVED | 2 | | text255 | default second_db | public | t22 | col3 | 3 | | YES | timestamp without time zone | | | | | | 0 | | raw | second_db | public | t22 | col4 | 4 | | YES | numeric | | 10 | 2 | | | 0 | | az64 |