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

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

# ALTER 範本
<a name="r_ALTER_TEMPLATE"></a>

變更現有範本的定義。使用此命令重新命名範本、變更範本的擁有者、從範本定義新增或移除參數，或設定參數值。

## 所需權限
<a name="r_ALTER_TEMPLATE-privileges"></a>

若要更改範本，您必須具有下列其中一項：
+ 超級使用者權限
+ 包含範本之結構描述的 ALTER TEMPLATE 權限和 USAGE 權限

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

```
ALTER TEMPLATE [database_name.][schema_name.]template_name
{
RENAME TO new_name
| OWNER TO new_owner
| ADD  parameter [AS] [value]
| DROP parameter
| SET parameter TO value1 [, parameter2 TO value2 , ...]
};
```

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

 *database\_name*   
（選用） 建立範本的資料庫名稱。如果未指定，則會使用目前的資料庫。

 *schema\_name*   
（選用） 建立範本的結構描述名稱。如果未指定，則會在目前的搜尋路徑中搜尋範本。

 *template\_name*   
要變更的範本名稱。

RENAME TO   
重新命名範本的 子句。

 *new\_name*   
範本的新名稱。如需有效名稱的相關資訊，請參閱 [名稱與識別碼](r_names.md)。

OWNER TO   
變更範本擁有者的子句。

 *new\_owner*   
範本的新擁有者。

ADD *參數* 【AS】 【*值*】  
將新參數新增至範本。  
+ 對於僅限關鍵字的參數 （例如 CSV 或 GZIP)，請僅指定參數名稱。
+ 對於需要值的參數，請指定參數名稱，後面接著 值。您可以選擇性地在參數和值之間包含 AS。

DROP *參數*  
從範本中移除指定的參數。無法使用單一 DROP 命令捨棄多個參數。

SET *參數* TO *value1* 【， *參數2* TO *value2* ， ...】  
更新現有範本參數的值。僅將 用於已有值的參數。您可以在單一命令中更新多個參數。

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

下列範例會將 test\_template 範本重新命名為 demo\_template。

```
ALTER TEMPLATE test_template
RENAME TO demo_template;
```

下列範例會將 demo\_template 結構描述的擁有權提供給使用者 bob。

```
ALTER TEMPLATE demo_template
OWNER TO bob;
```

下列範例將參數`CSV`新增至 template demo\_template

```
ALTER TEMPLATE demo_template
ADD CSV;
```

下列範例將參數`TIMEFORMAT 'auto'`新增至 template demo\_template

```
ALTER TEMPLATE demo_template
ADD TIMEFORMAT 'auto';
```

下列範例`ENCRYPTED`會從範本 demo\_template 捨棄參數

```
ALTER TEMPLATE demo_template
DROP ENCRYPTED;
```

下列範例會將 `DELIMITER` 參數設定為 ，`'|'`並將 `TIMEFORMAT` 參數設定為 `'epochsecs'`：

```
ALTER TEMPLATE demo_template
SET DELIMITER TO '|', TIMEFORMAT TO 'epochsecs';
```