Amazon Redshift는 패치 198부터 새 Python UDF 생성을 더 이상 지원하지 않습니다. 기존 Python UDF는 2026년 6월 30일까지 계속 작동합니다. 자세한 내용은 [블로그 게시물](https://aws.amazon.com/blogs/big-data/amazon-redshift-python-user-defined-functions-will-reach-end-of-support-after-june-30-2026/)을 참조하세요.
# SHOW COLUMNS
테이블의 열 목록과 일부 열 속성을 표시합니다.
각 출력 행은 쉼표로 구분된 데이터베이스 이름, 스키마 이름, 테이블 이름, 열 이름, 서수 위치, 열 기본값, null 가능, 데이터 유형, 문자 최대 길이, 숫자 정밀도, 비고, 정렬 키 유형, 정렬 키 순서, 배포 키, 인코딩 및 데이터 정렬의 목록으로 구성됩니다. 이들 속성에 대한 자세한 내용은 [SVV\_ALL\_COLUMNS](r_SVV_ALL_COLUMNS.md) 섹션을 참조하세요.
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](r_ALTER_SYSTEM.md) 섹션을 참조하세요.
*schema\_name*
나열할 테이블이 포함된 스키마의 이름입니다.
AWS Glue Data Catalog 테이블을 표시하려면 AWS Glue 데이터베이스 이름을 스키마 이름으로 제공하세요.
*table\_name*
나열할 열이 포함된 테이블의 이름입니다.
*filter\_pattern*
테이블 이름과 일치하는 패턴이 있는 유효한 UTF-8 문자 표현식입니다. LIKE' 옵션은 다음과 같은 패턴 일치 메타문자를 지원하는 대/소문자 구분 일치를 수행합니다:
[See the AWS documentation website for more details](http://docs.aws.amazon.com/ko_kr/redshift/latest/dg/r_SHOW_COLUMNS.html)
**filter\_pattern에 메타 문자가 포함되어 있지 않으면 패턴이 문자열 자체만 의미합니다. 이런 경우에는 LIKE가 등호 연산자와 동일한 역할을 합니다.
*row\_limit*
반환할 최대 열 수입니다. **row\_limit는 0\~10,000일 수 있습니다.
## 예제
다음 예제에서는 Amazon Redshift 데이터베이스에서 `sample_data_dev`라는 이름의 열이 `tickit` 스키마 및 `event` 테이블에 있는 경우를 보여 줍니다.
```
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 |
```
다음 예제에서는 `awsdatacatalog`라는 이름의 AWS Glue Data Catalog 데이터베이스에 있는 `batman` 스키마 및 `nation` 테이블에 있는 테이블을 보여줍니다. 출력은 `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 |
```