

 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/)。

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# SHOW COLUMNS
<a name="r_SHOW_COLUMNS"></a>

顯示資料表中的資料欄清單，以及某些資料欄屬性。

每個輸出列都包含以逗號分隔的資料庫名稱、結構描述名稱、資料表名稱、資料欄名稱、順序位置、資料欄預設值、為 null 值、資料類型、字元長度上限、數值精確度、備註、排序索引鍵類型、排序索引鍵順序、分佈索引鍵、編碼和定序。如需這些屬性的相關資訊，請參閱 [SVV\_ALL\_COLUMNS](r_SVV_ALL_COLUMNS.md)。

如果 SHOW COLUMNS 命令所產生的資料欄超過 10,000 個，則會傳回錯誤。

## 所需的許可
<a name="r_SHOW_COLUMNS-privileges"></a>

若要檢視 Amazon Redshift 資料表中的欄，目前使用者必須符合下列其中一項條件：
+ 身為超級使用者。
+ 是資料表的擁有者。
+ 在上層結構描述上具備 USAGE 權限，以及在資料表上具備 SELECT 權限，或在欄上具備 SELECT 權限。

## 語法
<a name="r_SHOW_COLUMNS-synopsis"></a>

```
SHOW COLUMNS FROM TABLE database_name.schema_name.table_name [LIKE 'filter_pattern'] [LIMIT row_limit ]
```

## Parameters
<a name="r_SHOW_COLUMNS-parameters"></a>

 *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/zh_tw/redshift/latest/dg/r_SHOW_COLUMNS.html)
如果 *filter\_pattern* 未包含任何中繼字元，則模式只代表字串本身，此時 LIKE 的功用如同等於運算子。

 *row\_limit*   
傳回的最大資料列數。*row\_limit* 可以是 0 到 10,000。

## 範例
<a name="r_SHOW_COLUMNS-examples"></a>

下列範例顯示 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 |
```

下列範例顯示名為 的 AWS Glue Data Catalog 資料庫中`awsdatacatalog`位於結構描述 `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     |
```