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/)을 참조하세요.

# PG\$1GET\$1COLS
<a name="PG_GET_COLS"></a>

테이블 또는 보기 정의에 대한 열 메타데이터를 반환합니다.

## 구문
<a name="PG_GET_COLS-synopsis"></a>

```
pg_get_cols('name')
```

## 인수
<a name="PG_GET_COLS-arguments"></a>

 * 이름*   
Amazon Redshift 테이블 또는 뷰의 이름입니다. 자세한 내용은 [이름 및 식별자](r_names.md) 섹션을 참조하세요.

## 반환 타입
<a name="PG_GET_COLS-return-type"></a>

VARCHAR 

## 사용 노트
<a name="PG_GET_COLS-usage-notes"></a>

PG\$1GET\$1COLS 함수는 테이블 또는 보기 정의에 있는 각 열에 대해 하나의 행을 반환합니다. 행에는 스키마 이름, 관계 이름, 열 이름, 데이터 형식 및 열 번호가 있는 쉼표로 분리된 목록이 포함되어 있습니다. SQL 결과의 형식 지정은 사용된 SQL 클라이언트에 따라 달라집니다.

## 예제
<a name="PG_GET_COLS-example"></a>

다음 예제는 연결된 데이터베이스 `dev`에서 사용자가 만든 스키마 `public`에 이름이 지정된 `SALES_VW` 뷰와 스키마 `mytickit1`에 이름이 지정된 `sales` 테이블 테이블에 대한 결과를 반환합니다.

다음 예는 `SALES_VW`라는 뷰에 대한 열 메타데이터를 반환합니다.

```
select pg_get_cols('sales_vw');

pg_get_cols                                                
-----------------------------------------------------------
(public,sales_vw,salesid,integer,1)                        
(public,sales_vw,listid,integer,2)                         
(public,sales_vw,sellerid,integer,3)                       
(public,sales_vw,buyerid,integer,4)                        
(public,sales_vw,eventid,integer,5)                        
(public,sales_vw,dateid,smallint,6)                        
(public,sales_vw,qtysold,smallint,7)                       
(public,sales_vw,pricepaid,"numeric(8,2)",8)               
(public,sales_vw,commission,"numeric(8,2)",9)              
(public,sales_vw,saletime,"timestamp without time zone",10)
```

다음 예는 테이블 형식의 `SALES_VW` 뷰에 대한 열 메타데이터를 반환합니다.

```
select * from pg_get_cols('sales_vw') 
cols(view_schema name, view_name name, col_name name, col_type varchar, col_num int);

view_schema | view_name | col_name   | col_type                    | col_num
------------+-----------+------------+-----------------------------+--------
public      | sales_vw  | salesid    | integer                     |       1
public      | sales_vw  | listid     | integer                     |       2
public      | sales_vw  | sellerid   | integer                     |       3
public      | sales_vw  | buyerid    | integer                     |       4
public      | sales_vw  | eventid    | integer                     |       5
public      | sales_vw  | dateid     | smallint                    |       6
public      | sales_vw  | qtysold    | smallint                    |       7
public      | sales_vw  | pricepaid  | numeric(8,2)                |       8
public      | sales_vw  | commission | numeric(8,2)                |       9
public      | sales_vw  | saletime   | timestamp without time zone |      10
```

다음 예는 테이블 형식의 `SALES` 스키마 `mytickit1`에 있는 테이블의 열 메타데이터를 반환합니다.

```
select * from pg_get_cols('"mytickit1"."sales"') 
cols(view_schema name, view_name name, col_name name, col_type varchar, col_num int);

view_schema | view_name | col_name   | col_type                    | col_num
------------+-----------+------------+-----------------------------+--------
mytickit1   | sales     | salesid    | integer                     |       1
mytickit1   | sales     | listid     | integer                     |       2
mytickit1   | sales     | sellerid   | integer                     |       3
mytickit1   | sales     | buyerid    | integer                     |       4
mytickit1   | sales     | eventid    | integer                     |       5
mytickit1   | sales     | dateid     | smallint                    |       6
mytickit1   | sales     | qtysold    | smallint                    |       7
mytickit1   | sales     | pricepaid  | numeric(8,2)                |       8
mytickit1   | sales     | commission | numeric(8,2)                |       9
mytickit1   | sales     | saletime   | timestamp without time zone |      10
```