ALTER TEMPLATE - Amazon Redshift
必要な権限構文パラメータ例

Amazon Redshift は、パッチ 198 以降、新しい Python UDF の作成をサポートしなくなります。既存の Python UDF は、2026 年 6 月 30 日まで引き続き機能します。詳細については、ブログ記事を参照してください。

ALTER TEMPLATE

既存のテンプレートの定義を変更します。このコマンドを使用して、テンプレートの名前を変更したり、テンプレートの所有者を変更したり、テンプレート定義にパラメータを追加または削除したり、パラメータ値を設定したりします。

必要な権限

テンプレートを変更するには、次のいずれかが必要です。

  • スーパーユーザー権限

  • テンプレートを含むスキーマに対する 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 , ...]
};

パラメータ

database_name

(オプション) テンプレートが作成されるデータベースの名前。指定しない場合は、現在のデータベースが使用されます。

schema_name

(オプション) テンプレートが作成されるスキーマの名前。指定しない場合は、現在の検索パスでテンプレートが検索されます。

template_name

変更するテンプレートの名前。

RENAME TO

テンプレートの名前を変更する句。

new_name

テンプレートの新しい名前。有効な名前の詳細については、「名前と識別子」を参照してください。

OWNER TO

テンプレートの所有者を変更する句。

new_owner

テンプレートの新しい所有者。

ADD パラメータ [AS] [値]

テンプレートに新しいパラメータを追加します。

  • キーワードのみのパラメータ (CSV や GZIP など) の場合は、パラメータ名のみを指定します。

  • 値を必要とするパラメータの場合は、パラメータ名に続けて値を指定します。オプションで、パラメータと値の間に AS を含めることができます。

DROP パラメータ

指定されたパラメータをテンプレートから削除します。1 つの DROP コマンドで複数のパラメータを削除することはできません。

SET パラメータ TO value1 [, parameter2 TO value2 , ...]

既存のテンプレートパラメータの値を更新します。値が既にあるパラメータにのみ使用します。1 つのコマンドで複数のパラメータを更新できます。

例

次の例では、test_template テンプレートの名前を demo_template に変更します。

ALTER TEMPLATE test_template
RENAME TO demo_template;

次の例では、demo_template スキーマの所有権をユーザー bob に与えます。

ALTER TEMPLATE demo_template
OWNER TO bob;

次の例では、テンプレート demo_template にパラメータ CSV を追加します。

ALTER TEMPLATE demo_template
ADD CSV;

次の例では、テンプレート demo_template にパラメータ TIMEFORMAT 'auto' を追加します。

ALTER TEMPLATE demo_template
ADD TIMEFORMAT 'auto';

次の例では、テンプレート demo_template からパラメータ ENCRYPTED を削除します。

ALTER TEMPLATE demo_template
DROP ENCRYPTED;

次の例では、DELIMITER パラメータを '|' に設定し、TIMEFORMAT パラメータを 'epochsecs' に設定します。

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