Amazon Redshift 將不再支援從修補程式 198 開始建立新的 Python UDFs。現有 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>

 *name*   
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>

下列範例會傳回結構描述 `public` 中名為 `SALES_VW` 之檢視的結果，以及使用者在連線資料庫 `dev` 中建立的結構描述 `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
```

下列範例以資料表格式傳回結構描述 `mytickit1` 中 `SALES` 資料表的欄中繼資料。

```
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
```