ALTER 範本 - Amazon Redshift
所需權限語法Parameters範例

Amazon Redshift 將不再支援從修補程式 198 開始建立新的 Python UDFs。現有 Python UDF 將繼續正常運作至 2026 年 6 月 30 日。如需詳細資訊，請參閱部落格文章。

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

ALTER 範本

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

所需權限

若要更改範本，您必須具有下列其中一項：

  • 超級使用者權限

  • 包含範本之結構描述的 ALTER TEMPLATE 權限和 USAGE 權限

語法

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

database_name

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

schema_name

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

template_name

要變更的範本名稱。

RENAME TO

重新命名範本的 子句。

new_name

範本的新名稱。如需有效名稱的相關資訊，請參閱 名稱與識別碼。

OWNER TO

變更範本擁有者的子句。

new_owner

範本的新擁有者。

ADD 參數 【AS】 【值】

將新參數新增至範本。

  • 對於僅限關鍵字的參數 （例如 CSV 或 GZIP)，請僅指定參數名稱。

  • 對於需要值的參數，請指定參數名稱，後面接著 值。您可以選擇性地在參數和值之間包含 AS。

DROP 參數

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

SET 參數 TO value1 【， 參數2 TO value2 ， ...】

更新現有範本參數的值。僅將 用於已有值的參數。您可以在單一命令中更新多個參數。

範例

下列範例會將 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';