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 파라미터

템플릿에서 지정된 파라미터를 제거합니다. 단일 DROP 명령을 사용하여 여러 파라미터를 삭제할 수 없습니다.

SET 파라미터 TO 값1 [, 파라미터2 TO 값2 , ...]

기존 템플릿 파라미터의 값을 업데이트합니다. 이미 값이 있는 파라미터에만 사용합니다. 단일 명령으로 여러 파라미터를 업데이트할 수 있습니다.

예제

다음 예시에서는 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';