SHOW COLUMNS - Amazon Redshift
필수 권한구문파라미터예시

Amazon Redshift는 2025년 11월 1일부터 새 Python UDF 생성을 더 이상 지원하지 않습니다. Python UDF를 사용하려면 이 날짜 이전에 UDF를 생성하세요. 기존 Python UDF는 정상적으로 계속 작동합니다. 자세한 내용은 블로그 게시물을 참조하세요.

SHOW COLUMNS

테이블의 열 목록과 일부 열 속성을 표시합니다.

각 출력 행은 쉼표로 구분된 데이터베이스 이름, 스키마 이름, 테이블 이름, 열 이름, 서수 위치, 열 기본값, null 가능, 데이터 유형, 문자 최대 길이, 숫자 정밀도 및 비고의 목록으로 구성됩니다. 이들 속성에 대한 자세한 내용은 SVV_ALL_COLUMNS 섹션을 참조하세요.

SHOW COLUMNS 명령으로 인해 10,000개 이상의 열이 반환되는 경우 오류가 반환됩니다.

필수 권한

Amazon Redshift 테이블에서 열을 보려면 현재 사용자가 다음 기준 중 하나를 충족해야 합니다.

  • 수퍼유저입니다.

  • 테이블의 소유자입니다.

  • 상위 스키마에 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' 옵션은 다음과 같은 패턴 일치 메타문자를 지원하는 대/소문자 구분 일치를 수행합니다:

메타문자 설명
% 0개 이상의 문자 시퀀스를 일치시킵니다.
_ 모든 문자를 일치시킵니다.

filter_pattern에 메타 문자가 포함되어 있지 않으면 패턴이 문자열 자체만 의미합니다. 이런 경우에는 LIKE가 등호 연산자와 동일한 역할을 합니다.

row_limit

반환할 최대 열 수입니다. row_limit는 0~10,000일 수 있습니다.

예시

다음 예제에서는 Amazon Redshift 데이터베이스에서 sample_data_dev라는 이름의 열이 tickit 스키마 및 event 테이블에 있는 경우를 보여 줍니다.

SHOW COLUMNS FROM TABLE sample_data_dev.tickit.event;

 database_name     | schema_name | table_name | column_name | ordinal_position | column_default | is_nullable | data_type                    | character_maximum_length | numeric_precision | numeric_scale | remarks 
-------------------+-------------+------------+-------------+------------------+----------------+-------------+------------------------------+--------------------------+-------------------+------------------------
 sample_data_dev   | tickit      | event      | eventid     |                1 | NULL           | NO          | integer                      | NULL                     |                32 | 0             | NULL
 sample_data_dev   | tickit      | event      | eventid     |                2 | NULL           | NO          | smallint                     | NULL                     |                16 | 0             | NULL
 sample_data_dev   | tickit      | event      | eventid     |                3 | NULL           | NO          | smallint                     | NULL                     |                16 | 0             | NULL
 sample_data_dev   | tickit      | event      | eventid     |                4 | NULL           | NO          | smallint                     | NULL                     |                16 | 0             | NULL
 sample_data_dev   | tickit      | event      | eventid     |                5 | NULL           | YES         | character varying            | 200                      |              NULL | NULL          | NULL
 sample_data_dev   | tickit      | event      | eventid     |                6 | NULL           | YES         | timestamp without time zo... | NULL                     |              NULL | NULL          | NULL

다음 예제에서는 awsdatacatalog라는 이름의 AWS Glue Data Catalog 데이터베이스에 있는 batman 스키마 및 nation 테이블에 있는 테이블을 보여줍니다. 출력은 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 |                          |                   |